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PREFACE 

This manual contains the Tutorial and Reference 
information for the Stemwriter // word processing and 
document preparation software for the Apple* //e and Apple 
//c personal computers. The information contained herein 
will guide you in a step-wise fashion through all of the 
available commands. 

Before you start reading this manual please take the 
time to fill in your Stemwriter // User Registration Card 
and post it to us at Stemsoft. Filling in this registration 
card has some important advantages for you, viz: 

1. If one of your Stemwriter // diskettes is accidentally 
damaged so that it cannot be used, it will be replaced at a 
nominal charge if you return it to us and you are a 
registered user. 

2. A User's advisory service will be maintained for helping 
you with any difficulties that you may encounter. You may 
contact us directly on the Source, by phone or by mail. 

So fill in your Stemwriter // User Registration Card 
now! If you don't do this, we cannot help you to get the 
best out of this product because we will not know who or 
where you are. 

An important first step in getting started is to become 
familiar with the essential features of your Apple //e or 
//c. The best way of doing this is to read the appropriate 
sections of your Apple //e or //c Owner's Manual, viz; 
Chapter 2, 'Getting Acquainted' and Chapter 3, 'How It 
Works'. 

The Stemwriter // manual is divided into 4 major parts, 
viz: INTRODUCTION, TUTORIAL', REFERENCE and UTILITIES. 

The introductory material in this manual contains an 
overview of the Stemwriter // program and general 
information to help you get started. 

Part 2 of this manual is a step-by-step Tutorial on how 
to use the Stemwriter // program with your Apple. 
Irrespective of whether or not you are familiar with 
personal computers you will find that many questions and 

• Apple is a registered trademark of Apple Computer Inc. 
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potential problems are pre-empted before they can arise. 

The Tutorial covers 5 main topics, viz: Editing, File 
Management, Formatting, Printing and Utilities commands. 
After working through the examples contained in the 
Tutorial, you will see how easy it is to use every feature 
of the Stemwriter program. Because all command options are 
selected in the same, easy to use manner, you will find that 
the full power of Stemwriter // is at your fingertips 
irrespective of how long it is since you last used this 
program. For this reason, Stemwriter is as equally suited 
to the author and report writer as to the typing pool 
environment. All that will be required is the occasional 
reference to the Stemwriter // Ready Reckoner. 

Part 3 of this manual comprises the Stemwriter // 
Technical Reference material. 

The information contained in the Utilities section 
(Part 4 of this Manual), allows you to configure your system 
for your printer, format diskettes, initialize the User 
Definable Keys, use various file management and list 
processing utilities such as sorting and selecting 
generalized records, e.g. Address Lists, Reference Lists or 
Standard Paragraphs. The keyboard organization is 
summarized on the Stemwriter // Ready Reckoner. 

Always remember that the best way to learn to use any 
computer program is to try it out. Experimenting with all 
of the Stemwriter // commands will help you gain in 
experience and confidence. You cannot hurt the Stemwriter 
program or the computer, so don't be inhibited in your 
experimentation. However, you must take very good physical 
care of both the computer and the diskettes. Gentle 
treatment of diskettes ensures their long life. This means 
keeping your diskettes away from dirt, liquids, sticky 
fingers and magnetic fields. 
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PART 1 

GETTING STARTED 

1.0 OVERVIEW 

The Stemwriter program incorporates many powerful 
features, all of which are very easy to use. This is true 
because the Desktop Metaphor (described below) has been 
carefully and consistently applied to the design of the 
'User Interface', i.e. how easy it is for you to use the 
Stemwriter program. 

Imagine that the cursor and your computer's display 
screen are like pencil and paper on your Desktop and that 
the Delete key is your eraser. When you want to rubout, you 
rub the character under the cursor just like you rub the 
character under the eraser on your piece of paper. If you 
want to change the character under the cursor, simply type 
the new character. This is like having a magic pencil which 
rubs the old character before it writes the new one. 

The computer's memory may contain up to 8 different 
documents, any two of which may be displayed on your screen 
simultaneously. This is like having up to 8 books or 
folders on your Desktop, any two of which may be open at the 
same time. The active document is the one in which the 
cursor is displayed. Similarly, on your Desktop, the active 
document is the one in which you are currently writing. 

When you are writing on your paper, you underline words 
to be underlined, lines are broken at sensible places, i.e. 
on whole or hyphenated words, you press harder with your 
pencil to emphasise important words and superscripts and 
subscripts are written in their correct relative positions. 
Thus the final appearance of your handwritten document is 
before your eyes, as you write it. The Stemwriter program 
works in a similar manner so that what you see on the 
computer's display screen is what will be printed out on 
paper. 

All Stemwriter commands are selected using the 4 arrow 
keys to 'see and point' at command options rather than 
having to 'remember and type' them. This means that you 
only have to recognize the command options you want, not 
remember them. Thus, there are no commands which are 'too 
hard' to use. 
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Using the Stemwriter program will become as much second 
nature to you as writing with a pencil and paper, as it 
works in the same intuitive way. You will find that 

Stemwriter does not intrude upon the task at hand, whether 

it be typing a document, creative writing directly onto the 
computer's screen or editing an earlier draft of a document. 
This means that the creation of reports, letters, technical 
papers, books, etc, whilst sitting at your keyboard is a 

very straightforward process. Try it! 

Note : If you are already using a word processor which 

imposes an arbitrary set of rules on the way you do things, 
you will have to unlearn those rules and return to the basic 
idea of writing on paper using a pencil and an eraser. If 
you do so, you will have no problems using Stemwriter. 

2.0 WHAT YOU NEED 

The minimum configuration for using the Stemwriter // 
program is: 

1. An Apple //e with an extended 80 column card installed 
(ensure that you attach the supplied graphics plug to 
your 80 column card as Stemwriter uses the graphics page 
of your computer's memory) or an Apple //c personal 
computer. 

2. A video monitor. 

3. Blank formatted 5 1/4" diskettes (See Lesson 16 for the 
formatting procedure). 

4. The Stemwriter // program. 

5. A printer (See Part 4 of this manual 'The Utilities', 
for configuring your printer). 

NOTE : You are supplied with two Stemwriter program 

diskettes. Put one of these diskettes in a safe place as 
your Backup copy and only use it if your working copy 
becomes so damaged that it is unuseable. 

3.0 KEYBOARD NOTES 

The keyboard layouts of the Apple //e and of the Apple 
//c are identical. It is important for using Stemwriter, 
that you know how the SHIFT, the OPEN-APPLE and CLOSED-APPLE 
keys work. You use the SHIFT key on the Apple //e or //c 
keyboard just as you use the SHIFT key on a typewriter, i.e. 
you hold it down while you type the key with the character 
you want. Thus by pressing the SHIFT key with the numeric 
keys at the top of the keyboard, you will obtain the symbols 
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at the top of these keys, viz. asterisk, exclamation mark, 
percentage sign, ampersand, etc. 

The OPEN-APPLE key (with the open-apple picture on it, 
at the bottom left of your keyboard), and the CLOSED-APPLE 
key (with the closed apple picture on it, at the bottom 
right of the space bar) work in the same way as the SHIFT 
key. You must hold the Open or Closed Apple key down while 
you press the other key you want. You release the Open 
Apple or Closed Apple key after you have released the other 
key. 


The numeric keys at the top of the keyboard are used 
either in conjunction with the Open Apple or Closed Apple 
keys as command keys. You use the RETURN key to accept a 
command line, otherwise the RETURN key works in the same way 
as the carriage return on a typewriter. 

The ARROW keys move the cursor up and down, left and 
right. You will use the arrow keys, called the cursor keys, 
a great deal when you are using the Stemwriter program. 

The ESCAPE key allows you to escape from any command 
that you do not wish to continue with, once you have 
selected it. The ALPHA LOCK key will enter a capital letter 
for the letters of the alphabet, but will not shift to give 
the symbol at the top of any key. 

N.B .: All keys on the Apple //e and //c keyboards have AUTO 
REPEAT. So you must NOT rest your hands on the keyboard. 

4.0 HANDLING OF DISKETTES 

HANDLE WITH CARE! Your diskettes are very susceptible 
to damage so take every precaution to ensure their good 
care. Each diskette is a small, magnetically coated plastic 
disk, sealed in a protective square plastic cover with an 
oval cutout, through which the magnetic surface of the 
diskette can be seen. 

NEVER touch the exposed magnetic surface with your 
fingers or with any implement. Don't bend, staple or write 
on the square plastic cover with a hard pen or pencil (use 
only soft felt tip pens). 

Protect your diskettes from dust by storing them in the 
paper jackets they come in. Keep your diskettes at least 15 
cms (6 inches) away from magnetic fields such as those 
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generated by your television and refrigerator. Extremes of 
temperature (such as in the glove compartment of your car or 
near the radiator) could destroy a diskette, and you would 
lose your data or your Stemwriter program - a very expensive 
lesson for the careless! 

5.0 PROGRAM AND STORAGE DISKETTES 

There are two distinctly different types of diskettes 
referred to in this manual, both of which should be treated 
with respect. The first type is the Stemwriter // program 
diskette, which has the Stemwriter program on it. You will 
be loading from the Stemwriter // program diskette every 
time you start up your computer for word processing 
(Detailed in Section 7.0 of this Introduction). Because the 
Stemwriter program diskette is copy-protected, you are 
supplied with two copies of it. Use one copy and put the 
other away as your Backup. If you treat the Stemwriter 
diskettes with care and respect, they will last for a very 
long time since the boot diskette spins for only a few 
seconds at the beginning of each word processing session. 

You will also be needing storage diskettes and you can 
have any number of these. The storage diskettes are where 
you will store the results of your word processing sessions 
so that you can retrieve your work at a later time. 

Before you can store your created document on a storage 
diskette, the diskette must firstly be formatted 
(initialized). Make sure you have at least one formatted 
blank storage diskette (and preferably more) before you load 
the Stemwriter program because you cannot format diskettes 
from within the Stemwriter program. It would be terrible to 
find that you have no blank formatted diskettes to save your 
document to because if this does happen, there is nothing 
you can do about it. The work will be lost as you will have 
to leave the Stemwriter program to format a diskette, and in 
so doing, you will lose the current document. Even if you 
have a formatted diskette, it might be too full to save the 
current document. Thus, you should always have at least one 
extra formatted blank diskette on hand. 

To format (initialize) a diskette you may either use 
the 'Format A Volume' command of the Stemwriter // Utilities 
program or the 'Format A Volume' command of the ProDOS 
filer. 
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Instructions on how to format diskettes are given in 
Lesson 16 of this Tutorial. 

6.0 PREPARING FOR THE STEMWRITER TUTORIAL 

As in any endeavour, the key to success is often found 
in careful preparation. Before using the Stemwriter program 
for the first time, the following should be done: 

: Prepare a supply of blank formatted diskettes. 

: Make a user copy of the Tutorial diskette, called 
MYTEXT. 

You may format (initialize) diskettes using either the 
•Format A Volume' command of the Stemwriter // Utilities 
program (Lesson 16), or the 'Format A Volume' command of the 
ProDOS filer. To copy the Stemwriter Tutorial Diskette, you 
will need to use the 'Copy one volume onto another' command 
of the ProDOS filer. It would be helpful to read Chapter 1 
of the ProDOS User's Guide before doing this. 

If you also wish to configure the Stemwriter program 
for your printer at this stage, then refer to Lesson 16.1 of 
this manual. You will also find useful information by 
referring to: 

* The documentation which accompanied your printer 

* The manual which accompanied the printer interface 
card. 

* Part 4, the Utilities, Chapter 2 of this manual 

* Part 3, the Reference Section, Chapter 2 of this 
manual. 

* The relevant chapter of the Owner's Guide which 
came with your computer. 


Note : It is not necessary to have a printer connected to 
your Apple //e or //c before you start using the Stemwriter 
program. 

7.0 LOADING THE STEMWRITER // PROGRAM 

Assuming that your Apple //e or //c is OFF (the Power 
light to the left of the space bar will be unlit) , prepare 
to start as follows: 
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First, make sure that your video monitor is connected 
to your Apple //e or //c and that both devices are plugged 
in. 


N.B .: Never touch the inside of your Apple, its interface 

cards, or external connections while the power is on. 

1. Turn your video monitor ON. 

2. Open the door of the boot disk drive by lifting it up. 
Then gently insert your Stemwriter // program diskette, 
label side up, with the label entering last. Close the 
drive door by pushing down on it until you hear it click 
shut. 

3. Turn on the power switch at the left rear corner of your 
Apple //e or //c. 

4. The red light on the boot disk drive will come on, and 
the Stemwriter program will be loaded into the computer's 
memory. 

Wait until the light on the disk drive goes off, then 
remove the Stemwriter program diskette, return it to its 
protective paper sleeve and put it in a safe place, such as 
a diskette storage box. Insert your user diskette, /MYTEXT, 
into the boot drive and close the door. You are now ready 
to start on the Tutorial and begin learning how to use the 
Stemwriter program. 

The Stemwriter greeting screen will be displayed as follows: 

Stemwriter // 
by 

Stemsoft 

Brisbane Australia 

Copyright (C) 1984 
Version 1.0 


Press: <space> to start 

<enter> to accept command line 

<esc> to reject command line 

<arrows> to modify command line 
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PART 2 


TUTORIAL 

1.0 LESSON 1 - STARTING OFF 

Before starting the Tutorial, make sure you have made a 
user copy of the Stemwriter tutorial diskette, /MYTEXT. 

1.1 Entering The Program 

This tutorial is designed to teach you how to use the 
Stemwriter program in a graded series of lessons. When you 
have completed Lesson 1, you will be able to create, re¬ 
margin, edit, and save simple documents. 

To begin, the Stemwriter program must be loaded into 
the memory of your Apple //e or //c. If you have not 
already done so, load your Stemwriter program now, as 
described in the preceding section entitled 'LOADING 
STEMWRITER'. When the Stemwriter program is loaded, press 
the SPACE BAR (a firm, sharp tap) to start, as the message 
at the bottom of the screen instructs you. 

The top of your screen should now appear as follows: 
Todays Date : Day!00] Month!00] Year!1900] 

The line displayed at the top of the screen is called 
the COMMAND LINE and the individual choices within a command 
line are called COMMAND LINE OPTIONS. Command Line options 
are selected using the 4 arrow (cursor) keys to cycle 
through the available options or by typing in numbers within 
the underlined boxes enclosed by the square brackets. This 
procedure will be explained in detail, in a few lines time. 

This particular command line is asking for today's 
date. The date you enter is used to date-stamp any 
documents you file away and to provide a rapid means of 
entering the correct date in your letters. Notice that the 
first digit in each box is underlined . This means that a 
number may be entered in the box. If your Apple has a 
working Clock/Calender installed, the date shown in the 
command line will probably be correct. If it is, just press 
RETURN once to accept this date. If the date is incorrect, 
proceed as follows: 
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Suppose today is the 10th February, 1985. The cursor 
should be positioned in the 'Day' box. To enter this date, 
type 1 then 0. If you make a mistake you can remove it by 
pressing the left arrow key until the error is removed since 
the left arrow key acts as a destructive backspace when the 
cursor is in a command line. The correct value can then be 
typed. To accept the new day value, press the RETURN key 
once. The cursor should now be in the 'Month' box. Type 
'2' (February is the second month) and accept the month by 
pressing RETURN once again. The cursor should now be in the 
Year box. Type in the full year, 1985 and accept it by 
pressing RETURN. When you are satisfied with the date 
displayed in the command line, press RETURN once again to 
accept the date. The Stemwriter program accepts any legal 
date from January 1, 1983 to December 31, 1999. If you 
enter an illegal date by mistake, Stemwriter will display 
the following error message in the command line: 

Bad Date-Try Again <Cont. on SPACE bar> 

Pressing the space bar will re-display the Date command 
line, so that you may try again. 

When the Date has been correctly entered, the next 
command line to be displayed is: 

Display :: Window [A] : Document [1] 

All options of this command line are as follows: 

Display :: Window [A] : Document tl] 

[B] [2] 

[C] m 

[4] 

[5] 

[6] 

[7] 

[ 8 ] 

This command line is asking you to tell the Stemwriter 
program which Window your document is to be displayed in. 
Window A is the whole screen, Window B is the top half of 
the screen only and Window C is the bottom half of the 
screen. As the Stemwriter program allows up to 8 documents 
to reside simultaneously in the computer's memory, you must 
tell the Stemwriter program the number (1-8) to be assigned 
to the document you are about to create. You may display 
two different documents on the screen simultaneously i.e. in 
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Windows B and C (the top and bottom halves of the screen 
respectively). Similarly, you can display two different 
parts of the same document on the screen simultaneously 
using the split screen facility. The power of this split 
screen facility will be illustrated in Lessons 3, 10 and 13. 

The procedure for selecting the Window to display your 
document in and for nominating the Document Number, is 
described as follows and is illustrated in Schematic la. In 
fact, the following description applies to all COMMAND LINE 
OPTION SELECTIONS. 

You use the 4 arrow keys to make your command line 
option selections. The down and up arrow keys move the 
cursor through the available options of a particular command 
in the forward and reverse directions respectively. As with 
all other keys on the Apple //e or //c keyboard, the arrow 
keys have AUTO REPEAT, so that if you hold them down, they 
will cycle through the options at a much faster rate than 
you are at first prepared for. Do not be alarmed, if you 
press the arrow keys with firm and crisp movements, the Auto 
Repeat will not occur. When the option you want is 
displayed, press the right arrow key once to move to the 
next set of command options, i.e. Document Number. Again 
cycle through the available options using the up/down arrow 
keys until the Document Number you want is displayed. 



Schematic la 

If there was another set of command options to the 
right of Document Number, you would press the right arrow 
key to move to this new set of command options and cycle 
through them using the up/down arrow keys as described 
above. However, as there are only two sets of command 
options in the current command line, pressing the right 
arrow key will move you from the Document Number options 
back to the Window options. This is because all sets of 
command options are contained in a horizontal closed loop. 
Pressing the right arrow key moves you through sets of 
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command options in the right direction and the left arrow 
key moves you through them in the left direction. 
Similarly, the permitted choices for all command options are 
contained in vertical closed loops such that the up arrow 
key moves you through the options in reverse order and the 
down arrow key moves you through them in the forwards 
direction. This description of the command line is 
illustrated in Schematic lb. 


-(■ 
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■ 
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Schematic lb 

Do not be afraid to use the arrow keys to get a feel 
for how the command line option selection works. You cannot 
do anything wrong and you cannot hurt the program. The 
Stemwriter program only recognizes the permitted choices in 
the command line. You cannot type in a new value e.g. if 
you try typing Z for your choice of Window, the computer 
beeps at you and the letter Z is ignored. Similarly, if you 
try to type 0 for your Document Number, the computer beeps 
and the 0 is ignored. In this way you cannot select an 
unavailable option. This also means that for command option 
selection you do not have to rely on your memory to recall 
all of the permitted command options because you are 'seeing 
and pointing' at the options rather than 'remembering and 
typing' them. In this way you always have the full 
flexibility of the command options at your fingertips, not 
buried somewhere in the User's Manual or in reams of 'HELP' 
files. 


Now make sure you are satisfied and comfortable with 
the way the command line options selection works. If you 
are, then proceed, if not, go back to the beginning of this 
Tutorial and have some more practice. 

If you are ready to go on, check that the Window you 
want your document to be displayed in, is selected at the 
top of the screen. Select Window A to start with. Now 
assign a number to the document you are about to create. 
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Select Document 1 to start with. The command line should 
read as follows: 

Display :: Window [A] : Document [11 

If it does, accept these options by pressing the RETURN 
key once. The RETURN key is ALWAYS used to accept the 
desired command line. N.B .: Press the RETURN key once 
only, i.e. with a short, sharp tap. Don't hold the RETURN 
key down because it has 'AUTO' repeat. If you have 
accidently pressed the RETURN key more than once, you will 
have jumped ahead a couple of stages without realising it. 
You may even have several blank lines at the top of your 
screen since pressing the RETURN key creates new lines when 
you are not in a command line. If this is the case, don't 
worry! At this stage you can just start again. Once you 
become familiar with Stemwriter you will realise that it is 
not really necessary to begin again, but at this early stage 
in the learning process, it is best to re-boot the system. 
Put the Stemwriter program diskette into the boot disk drive 
of your Apple //e or //c and press the CONTROL key 
simultaneously with the OPEN-APPLE key and the RESET button 
at the upper righthand side of the keyboard. You can now 
begin the Tutorial again. 

After selecting the window to display your document in, 
the command line at the top of the current window should 
read as follows: 

Line : Para Indent[5 ] Line Indent [0 ] Line Width [72 ] 

This command line is used to select the Paragraph 
Indent, Line Indent and Line Width values to be used for 
creating your document. Notice that the first digit inside 
the square brackets is UNDERLINED. This means that if you 
don't want the default values of these parameters, you may 
type a number inside the square brackets. For example, to 
change the paragraph indent from 5 to 10 characters, 
position the cursor inside the square brackets associated 
with the command option PARA INDENT and type the number 10. 
Now press the RETURN key once to accept the new value. When 
you have done this, the cursor should be positioned inside 
the square brackets associated with the LINE INDENT option. 
As the Line Indent is not being changed, press the right 
arrow key once to position the cursor inside the square 
brackets associated with the LINE WIDTH option. To select 
the new Line Width value you want, e.g. 60 characters, type 
the number 60 and press RETURN to accept this new Line Width 
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value. The command line should now read: 


Line : Para Indent [10 ] Line Indent [0 ] Line Width [60 ] 

If you are happy with this command line, accept it by 
pressing RETURN. The screen window should now be clear 
except for the CURSOR positioned in the upper left-hand 
corner. The Stemwriter program is now ready for you to 
start entering text. For the first exercise, type the 
passage of text entitled 'EXAMPLE DOCUMENT 1' (Figure 1.1). 
Read it first and then type it onto your screen. 

Notice the passage of text begins with a new paragraph. 
How is a new paragraph selected? The NEW PARAGRAPH command 
is a single keystroke operation. Press (a short, sharp tap) 
Closed Apple 1 once. The cursor is now positioned two lines 
down and 10 characters in from the left margin. Remember 
you chose a Para Indent of 10 characters earlier. If you 
had chosen 5 characters for the Para Indent, the cursor 
would be positioned 5 characters in from the left margin. 
Each time you want a new paragraph, press Closed Apple 1 and 
the cursor will be automatically positioned correctly for 
you. If you prefer the NEW PARAGRAPH key to put in one 
instead of two lines between paragraphs, you may adjust the 
Stemwriter program to do this, using the Stemwriter 
Configuration program (See Part 4 of this manual). 

Begin typing Example Document 1, character by 
character, including the deliberate typing errors. Put in 
the appropriate spaces, but do not put in carriage returns. 
The Stemwriter program automatically calculates the correct 
line breaks and inserts them in the text. If you make any 
typing errors, leave them for now, and we will fix them 
later. Now begin typing EXAMPLE DOCUMENT 1. If you do not 
want to type in Example Document 1, it is supplied to you on 
the diskette, /MYTEXT, as the file, /MYTEXT/EX.DOC.l.LIB. 
Load the file, /MYTEXT/EX.DOC.l.LIB, into the computer's 
memory as Document 1, by following the detailed instructions 
for this, given at the beginning of Lesson 2. 

When you have entered all of EXAMPLE DOCUMENT 1 into 
the computer's memory as Document 1, STOP! Before using the 
EDITING commands of the Stemwriter program, SAVE this 
document to diskette. Don't worry about any typographical 
errors at this stage. 
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The preparation of ducuments can ofen be a tedious 
and laborious process involving several draft stages. This 
is a good reason for looking for ways of reducing the amount 
of time and effort required for these types of tasks. With 
the widespread introduction of microcomputers in the late 
1970's, many enterprising individuals recognized that with a 
suitable set of instructions, microcomputers could become 
very useful tools for many tasks including document 
preparation. 

So began the introduction of the first 
microcomputer based word processing programs. There are now 
many word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

The most important feature of all is 'User 
Friendliness'. In general, the easier it is for you to use 
the word processing program i.e. the less cryptic its 
commands and the more it resembles the natural way of doing 
things with a pencil and paper, the more effort has gone 
into designing and writing the word processing program. 

The best word processing programs have many 
editing and formatting features but they do not require you 
to memorize them all. Instead they allow you to 'see and 
point' at the command options you want rather than having to 
'remember and type' them. It is this philosophy which is 
embodied in the Stemwriter program. 

This is the end of Example Document 1. 

Figure 1.1 Example Document 1. 

1.2 Saving A Document On Diskette 

In this Stemwriter manual, we refer to both DOCUMENTS 
and FILES which are used consistently as follows: 

A Document is a collection of alphanumeric characters 
which may occupy all or part of the computer's memory. The 
Stemwriter program allows up to 8 independent documents of 
arbitrary size to reside in the computer's memory 
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simultaneously. Each document is identified and kept track 
of by the Stemwriter program by way of its unique number - 
from 1 to 8. When you store the contents of a document onto 
a disk, you must give the information a name. The stored 
information is then referred to as a named FILE. 

To summarize: When information is in the computer's 
memory, it is known as a numbered Stemwriter Document. When 
the same information is written onto a diskette for storage, 
it is known as a named Stemwriter File. This is how 
Documents and Files will be referred to consistently 
throughout this manual. 

By saving Example Document 1 onto a diskette at this 
stage, you are protecting yourself against the occurrence of 
an unlikely event such as a power failure. Once the 
document is saved, you can re-load the text into the 
computer's memory at any future time. If you haven't 
already done so, take out your user diskette, /MYTEXT. 

Check that the red light of the boot disk drive is off, 
then open the drive door. If you have not previously 
removed your Stemwriter diskette, do it now CAREFULLY and 
replace it in its paper sleeve. Put it aside in a safe 
place. 

Gently push the diskette, /MYTEXT, all the way into the 
drive (label side up, entering last) and close the drive 
door. 


To SAVE your document, press the CLOSED APPLE key in 
conjunction with the 7 key. The command line will read: 

[Load] [whole] File [without] Encryption and [without] Backup 


Don't panic because you see the word LOAD and not SAVE 
in the command line, you will soon understand why. All 
options of this command line can be represented in shorthand 
form as follows: 

[Load] [whole] File [without] Encryption and [without] Backup 
[Save] [segt.] [with ] [with ] 

The options presented the first time this command line is 
activated are shown on the top line. We will use this 
shorthand form frequently in the following lessons, to 
summarise command line options. As stated earlier, the 
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arrow keys are used to cycle through and display the command 
line options you want. 

The cursor is positioned on [Load]. Press either the 
up or down arrow key once and [Save] will appear. Press it 
again and [Load] re-appears. Press it again and [Save] will 
re-appear. 

Press the right arrow key once to position the cursor 
on [whole]. Press either the up or down arrow key once and 
[segt.] will appear in the command line. [segt.] refers to 
a segmented file which is a file that is composed of a 
series of independently accessible pieces of information. 
For more detail on segmented files, see Lesson 8. Suffice 
it to say that EXAMPLE DOCUMENT 1 is a WHOLE file and will 
be saved as such. 

Press the up/down arrow key once more and [whole] re¬ 
appears. Get the idea! The command line should now read: 

[Save] [whole] File [without] Encryption and [without] Backup 


Press the right arrow key a second time to position the 
cursor on [without]. Press either the up or down arrow key 
once and [with ] appears. You would SAVE a file with 
encryption if it were of a sensitive nature and for 
restricted viewing only. More on this in Lesson 8. Press 
the up or down arrow key again and [without] re-appears. 
Save Example Document 1 without Encryption. 

Press the right arrow key again and the cursor is 
positioned on [without]. This enables you to save files 
without Backup. Press either the up or down arrow key once 
and [with ] appears. By saving a file with Backup, you 
are automatically protected against accidental overwriting 
of your files, since the existing file under a particular 
name is first renamed as a back-up file before the new file 
is saved. More about this in Lesson 8. You should save 
with Backup because it is a good habit to get into, to 
protect yourself against accidental over-writing of an 
existing file. The command line should now read: 

[Save] [whole] File [without] Encryption and [with ] Backup 
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When a file is being saved for the first time, the 
Stemwriter program recognizes there is no file to be backed 
up. 


Now that the desired Save options are displayed in the 
command line, accept them by pressing RETURN. Remember, one 
short, sharp tap. The command line will now read: 

Patht 1 

You must now tell the Stemwriter program the PATHNAME 
of the file to be saved. You can do this using a 
combination of the arrow keys and typing. Press the down 
arrow key once. The name of the diskette contained in the 
boot disk drive, in this case that of your user diskette, 
/MYTEXT, will appear in the command line as follows: 

Patht/MYTEXT ] 

If you have more than one disk drive on-line, each time 
you press the up/down arrow key, the Stemwriter program will 
automatically write the name of the diskette contained in an 
additional disk drive or of the Profile hard disk, into the 
first position of the command line. 

Next, press the SLASH key once. The command line will 

read: 

Path!/MYTEXT/ ] 

You must now enter the file name that Document 1 is to 
be saved under, i.e. EX.DOC.1. So, type EX.DOC.1 after the 
slash in the command line as follows: 

Patht/MYTEXT/EX.DOC.1 ] 


Each portion of a file pathname cannot be more than 15 
characters long. It is necessary to give your file a unique 
name because there is enough space on a diskette to hold 
several files. By assigning a unique name to your file, you 
can find it at some later time and load it back into the 
compute r 1 s memory. 

If you are happy with the pathname, /MYTEXT/EX.DOC.1, 
to be assigned to Example Document 1, press RETURN. The 
message 

Stemwriter Busy .. 
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will appear in the command line, the red light will come on 
in the boot disk drive and it will begin to whirr. This 
will continue until all of Example Document 1 is written 
onto your user diskette, /MYTEXT, as the file called 
/MYTEXT/EX.DOC.1. 

1.3 Moving The Cursor Over The Text 

In order to correct any typographical errors you may 
have made when creating Example Document 1, you must be able 
to move the cursor over the text in an efficient manner. 
The cursor can be moved forwards and backwards over the text 
by character, word, line and paragraph. The cursor can also 
be moved to the head of a document and to the tail of a 
document. 

1.3.1 Jumping To The Head Or Tail Of A Document 

After saving the Example Document as /MYTEXT/EX.DOC.1, 
the cursor should be positioned at the end of Document 1. 
To move the cursor to the head of this document, press the 
Closed Apple key in conjunction with key 8. The command 
line will now read 


Jump to Doc. [Head] 

with the cursor positioned on [Head]. Press RETURN to 
accept this command line. The cursor will now be positioned 
at the head of this document (Figure 1.2). 

To JUMP to the end of the document, press Closed Apple 
8 again and press the down arrow key once to adjust the 
command line to read: 


Jump to Doc. [Tail] 

Press RETURN. The cursor will now be positioned at the end 
of the document (Figure 1.3). 

Press Closed Apple 8 and adjust the command line in the 
usual way to read: 

Jump to Doc. [Head] 

Press RETURN. The cursor will now be positioned at the head 
of the document again. 
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The preparation of documents can often be a 
tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of time and effort required for these 
types of tasks. With the widespread introduction of 
microcomputers in the late 1970's, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcomputers could become very useful tools 
for many tasks including document preparation. 

So began the introduction of the first 
microcomputer based word processing programs. There are now 
many word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

Figure 1.2 The cursor is at the head of Document 1. 


into designing and writing the word processing program. 

The best word processing programs have many 
editing and formatting features but they do not require you 
to memorize them all. Instead they allow you to 'see and 
point' at the command options you want rather then having to 
'remember and type' them. It is this philosophy which is 
embodied in the Stemwriter program. 

This is the end of Example Document l.B 

Figure 1.3 The cursor is at the tail of Document 1. 

1.3.2 Moving By Character 

The cursor is moved over the text by character using 
the left and right arrow keys. Press the right arrow key 
once. The cursor moves one character to the right. Press 
the right arrow key three or four more times. Notice the 
cursor moves forward one character position with each press 
of the right arrow key. Similarly, pressing the left arrow 
key moves the cursor backwards, one character position at a 
time until you stop pressing the left arrow key or you reach 
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the top of the document. If you hold down the right arrow 
key, the cursor moves forwards quite rapidly until you 
release it or you reach the tail of the document. Holding 
down the left arrow key moves the cursor backwards in a 
similar manner. This is because of the AUTO REPEAT feature 
of the keyboard. In this way you can move the cursor over 
the text, character by character, quite rapidly. 

Do NOT try to use the space bar to move the cursor 
forwards over the text because the space bar replaces 
existing characters by spaces. The space bar is for 
producing SPACES only. If you accidentally replace a 
character by a space, you can fix it by positioning the 
cursor over the space and re-typing the character. It is as 
easy as that. The same strategy applies for correcting 
typing mistakes. Position the cursor over the mistyped 
character and type the correct character in its place. 

1.3.3 Moving By Word 

To move the cursor forwards and backwards over the text 
by word, press the Open Apple key in conjunction with the 
right and left arrow keys respectively. Try it! 

1.3.4 Moving By Line 

You can move the cursor forwards and backwards over the 
text by line in one of two ways. Pressing the down and up 
arrow keys moves the cursor forwards and backwards 
respectively by line with the cursor being positioned at the 
same point in each line. That is, if the cursor was 
originally 16 characters in from the left margin, it will be 
maintained in that position as you move the cursor up or 
down over the text. 

The second method for moving the cursor forwards and 
backwards by line over the text, positions the cursor at the 
next head of a line. Position the cursor at the head of the 
document, in the middle of the first line. You already know 
how to do this, i.e. press Closed Apple 8 and adjust the 
command line to read: 

Jump to Doc. [Head] 

Press RETURN. Now move the cursor to the middle of the 
first line by word or by character, whichever you like. 
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Press the RETURN key once to move the cursor to the 
head of the next line. Press the RETURN key several more 

times. Each time you press the RETURN key, the cursor moves 

forward successively to the head of the next line. Note 

that at the END of the document, the RETURN key forces a New 

Line for text entry. 

Move the cursor to the middle of the current line and 
press the Open Apple key in conjunction with the RETURN key. 
This moves the cursor to the head of the current line. 
Press Open Apple RETURN again. The cursor moves backwards 
by one line and is positioned at its head. If the cursor is 
in the middle of a line of text, pressing Open Apple RETURN 
moves the cursor to the head of the current line. If the 
cursor is already at the head of the line, pressing Open 
Apple RETURN moves the cursor backwards over the text by 1 
line with the cursor always positioned at the head of the 
line. 

1.3.5 Moving By Paragraph 


Using the JUMP to Document Head command (press Closed 
Apple 8, etc), move the cursor to the head of the document. 
To move the cursor to the head of the next paragraph, press 
Closed Apple 1. If you press Closed Apple 1 again, the 
cursor moves to the head of the next paragraph. Pressing 
Closed Apple 1 moves the cursor over the text of a document 
by paragraph, provided the paragraphs were originally 
* created using Closed Apple 1. Two carriage returns in 
succession are not recognized by the Stemwriter program as 
marking the start of a new paragraph. 




, Move the cursor to the end of the document using the 
JUMP^to Document Tail command. Press the Open Apple key 
with the 1 key. Notice the cursor moves backwards to the 
head of the current paragraph. If you press Open Apple 1 
aga^n, the cursor moves to the head of the previous 
paragraph. Each time you press Open Apple 1, the cursor 
moves backwards over the text to the head of the previous 
'paragraph. 


Note : WE»n the cursor is positioned at the tail of the 

document,pressing Closed Apple 1 CREATES a new paragraph. 

1.3.6 Tabbing 


The Stemwriter program allows up to 16 independent tab 
stops to be set for each document in the computer's memory. 
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At start-up time, the 16 tabs are set 8 columns apart, 
beginning at column 8. Position the cursor at the head of 
the current line, if it is not there already. That's right, 
press Open Apple RETURN. Now press the TAB key once. 
Notice the cursor moves 8 columns across the screen. Each 
time you press the Tab key, the cursor moves a further 8 
columns across the screen. The tab settings may be cleared 
and set individually or as a total group and the tab 
positions may be shown at the top of the current window. 
See Lesson 4 for the detailed instructions on SETTING THE 
TABS. If you don't feel confident of your ability to move 
the cursor quickly and efficiently to any position in your 
document, go back to the beginning of Lesson 1.3 and work 
your way through it again. 

1.4 Correcting Typographical Errors 

Move the cursor to the head of the document using the 
JUMP to Document Head command. Press Closed Apple 8 and 
adjust the command line to read: 

Jump to Doc. [Head] 

Press RETURN. The cursor should now be positioned at the 
head of the document. 

For single character typing mistakes in your document, 
move the cursor to the typographical error and simply type 
the correcjt character in its place. For example, if instead 
of 'documents' in the first line of EXAMPLE DOCUMENT 1, you 
have 'ducuments', position the cursor over the 'u' and type 
'o'. The word is now correctly spelt 'documents'. It is as 
simple as that! If you mistype a whole word, you can 
correct it by placing the cursor at the beginning of the 
mistyped word and type the correct letters over the top of 
the incorrect ones. Easy, isn't it? 

1.5 Rubbing Out By Character 

If a word contains any extra letters, place the cursor 
over the surplus letter and press the DELETE key once. Each 
time you press the DELETE key, the character beneath the 
cursor is removed irrespective of whether it is a space or 
an alphanumeric character. The DELETE key erases characters 
and spaces, one at a time, until the end of the current 
line. It will not remove Special Field characters, such as 
Underlining, Bold, etc. For removing larger blocks of text, 
or Special Field characters, refer to Lesson 3 on Block 


Lesson 1 




24 


Part 2 - Tutorial 


Operations, and Lesson 7 on Fields, respectively. 

To re-margin the text after a RUBOUT operation, simply 
COT and PASTE the text, i.e. press Closed Apple 0 twice. 

1.6 Cutting And Pasting 

If a character was left out of a word, e.g. if you 
typed 'ofen' in the first line of EXAMPLE DOCUMENT 1, 
instead of 'often', the omission can be corrected using the 
CUT and PASTE command. Position the cursor at the point in 
the word where the missing letter should be. In this case, 
place the cursor over the 'e' in 'ofen'. Now press Closed 

Apple 0 to CUT the text. The message 'Text Cut' will 
appear at the top of the current window. Type the missing 
't' in the word 'ofen' and re-join the text by pressing 
Closed Apple 0 again. This is PASTING the text. The 
message 'Text Rejoined' will appear at the top of the 
screen. 

To summarize, pressing Closed Apple 0 once, CUTS the 
text. Pressing Closed Apple 0 a second time, PASTES the 
text. The Stemwriter program keeps track of the number of 
times you press Closed Apple 0 and it displays the 

appropriate message, i.e. 'Text Cut' or 'Text Rejoined' 
above the current window. When the text is cut, you can 
insert as little as 1 character or as much new text as you 
like at the cut position. When you re-join the text, the 

document is ALWAYS automatically re-margined to absorb the 

inserted text into the document. 

1.7 Saving Your Corrected Document On Diskette 

When you have corrected every typographical error in 
Example Document 1, save the amended version to your user 
diskette as the file, /MYTEXT/EX. DOC. 1. If you save the 
file with Backup, the previous version of /MYTEXT/EX.DOC.1 
will become /MYTEXT/EX.DOC.1.BAR, and the current version 
will be /MYTEXT/EX.DOC.1. Before proceeding, make sure that 
your user diskette, /MYTEXT, is in the boot drive of your 
Apple //e or //c. 

Now press Closed Apple 7 and using the arrow keys in 
the usual way, adjust the command line to read: 

[Save] [whole] File [without] Encryption and [with ] Backup 

Press RETURN to accept this command line. If you are 
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following on from Lesson 1.2, the next command line will 
show the prefix: 

Path[/MYTEXT J 

If it does, then skip the next two steps. If it shows some 
other prefix, press the left arrow key (a destructive back 
space) until it is clear as follows: 

Path! 1 

You must now enter the Pathname of the file to be saved. 
Press the down arrow key once. As your user diskette, 
/MYTEXT, is in the boot drive, the command line will read: 

Path[/MYTEXT ] 

Now press the right arrow key once. The pathname should now 

read: 

Path[/MYTEXT/EX.DOC.1 ] 

If a name other than EX.DOC. 1 is displayed in the second 
position of the file pathname, press the down arrow key 

until EX. DOC. 1 is displayed at this position. Now press 

RETURN. The message 

Stemwriter Busy .. 

will now be displayed in the command line, the red light in 
the disk drive will come on and the disk will begin to 
whirr. The previous copy of EX.DOC.1 will firstly be 

renamed to /MYTEXT/EX.DOC.1.BAR, and the current version of 
Document 1 will be written to your user diskette as the 

file, /MYTEXT/EX.DOC.1. 

1.8 Re-margining A Document 

To re-margin Document 1 in the computer's memory so 
that it has a Para Indent of 5 characters and a Line Width 
of 55 characters, press Open Apple 9 and adjust the command 
line to read: 


Set Global data for 

[Line] break calculation 

Press RETURN. The 

command line will 

now 

read: 

Line : Para Indent 

[10 ] Line Indent 

[0 

] Line Width [60 ] 
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The cursor is positioned inside the square brackets 
associated with Para Indent. Type 5 and press RETURN to 
accept the new Para Indent value. The cursor will now be 
positioned inside the square brackets associated with Line 
Indent. As the Line Indent is not being changed, press the 
right arrow key once to position the cursor inside the 
square brackets associated with Line Width. Type 55 and 
press RETURN to accept the new Line Width value. The 
command line should now read: 

Line : Para Indent [J5 ] Line Indent [0 ] Line Width [55 ] 

Press RETURN. The screen will clear momentarily and 

Document 1 will be displayed with its new Para Indent and 
Line Width values (Figure 1.4). That is all there is to it! 


The preparation of documents can often be a 
tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of time and effort required for 
these types of tasks. With the widespread introduction 
of microcomputers in the late 1970's, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcomputers could become very useful 
tools for many tasks including document preparation. 

So began the introduction of the first 
microcomputer based word processing programs. There 
are now many word processing programs to choose from, 
varying in sophistication from the most rudimentary 
line oriented text editors with minimal formatting 
capabilities, to the very advanced integrated software 
packages comprising equally sophisticated editing and 
formatting functions. 

The most important feature of all is 'User 
Friendliness'. In general, the easier it is for you to 
use the word processing program i.e. the less cryptic 

Figure 1.4 Document 1 is re-margined with a Para 

Indent of 5 characters and a Line Width of 
55 characters. 
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1.9 Hanging Indents And Bulleted Paragraphs 

Stemwriter produces 'Hanging Indents' and 'Bulleted 

Paragraphs' according to the following rules: 

1. When you press either the RETURN or the NEW PAGE key to 
produce an unconditional line break, the Stemwriter 
program returns the cursor to the left margin. 

2. When you press the NEW PARA key to produce an 

unconditional line break, the Stemwriter program indents 
the cursor the required number of characters from the 
left margin specified by you for the start of a new 

paragraph. 

3. For conditional line breaks, such as occur when the 

Stemwriter program breaks the text for you, the 

Stemwriter program indents the text the exact number of 
characters you specified in the 'Line Indent' portion of 
the command line. 


If you want only part of your document to have 'Hanging 
Indents' or 'Bulleted Paragraphs', you must create the 
indented text in a Local Field as described in Lesson 7.6. 

1.9.1 Hanging Indents 

Paragraphs with 'hanging indents' have their first line 
at the left margin and all subsequent lines indented with 
respect to the first line. 

Try re-margining Document 1 in the computer's memory so 
that all paragraphs have a Para Indent of 0 characters, a 
Line Indent of 5 characters and a Line Width of 58 
characters. To do this, press Open Apple 9 and adjust the 
command line to read: 

Set Global data for [Line] break calculation 
Press RETURN. The next command line will read: 

Line : Para Indent [5 ] Line Indent [J) ] Line Width [58 ] 

Adjust this command line in the usual way, to show a Para 

Indent of 0, a Line Indent of 5 and a Line Width of 58 
characters, as follows: 
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Line : Para Indent [0 ] Line Indent [jj ] Line Width [58 ] 

Press RETURN. Document 1 will now be re-margined so that 
all paragraphs have 'hanging indents' of 5 characters 
(Figure 1.5). 


The preparation of documents can often be a tedious and 
laborious process involving several draft stages. 
This is a good reason for looking for ways of 
reducing the amount of time and effort required for 
these types of tasks. With the widespread 

introduction of microcomputers in the late 1970's, 
many enterprising individuals recognized that with a 
suitable set of instructions, microcomputers could 
become very useful tools for many tasks including 
document preparation. 

So began the introduction of the first microcomputer based 
word processing programs. There are now many word 
processing programs to choose from, varying in 
sophistication from the most rudimentary line 
oriented text editors with minimal formatting 
capabilities, to the very advanced integrated 
software packages comprising equally sophisticated 
editing and formatting functions. 

The most important feature of all is 'User Friendliness'. 
In general, the easier it is for you to use the word 
processing program i.e. the less cryptic its commands 

Figure 1.5 Document 1 with a Para Indent of 0, Line 

Indent of 5 and Line Width of 58 characters. 


1.9.2 Bulleted Paragraphs 

When all of the text contained in a paragraph is 
indented with respect to the remainder of the document, you 
have a 'Bulleted Paragraph'. Bulleted paragraphs are 
normally produced in association with Local Fields (see 
Lesson 7.6). 

To re-margin Document 1 in the computer's memory so 
that every line of text is indented 5 characters with 
respect to the left margin and each line is 60 characters 
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wide, press Open Apple 9 and adjust the command line to 
read: 


Set Global data for [Line] break 

calculation 


Press RETURN 

and adjust 

the next 

command 

line to 

read: 

Line : Para 

Indent [5 

) Line Indent [5 

] Line 

Width [60 3 


Press RETURN. Document 1 will now be re-margined such that 
every line of text is indented 5 characters from the left 
margin (Figure 1.6). To check that this is indeed the case, 
press Open Apple RETURN to move the cursor to the head of 
the current line. 


The preparation of documents can often be a tedious and 
laborious process involving several draft stages. This 
is a good reason for looking for ways of reducing the 
amount of time and effort required for these types of 
tasks. With the widespread introduction of 

microcomputers in the late 1970's, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcomputers could become very useful 
tools for many tasks including document preparation. 

So began the introduction of the first microcomputer 
based word processing programs. There are now many 
word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented 
text editors with minimal formatting capabilities, to 
the very advanced integrated software packages 
comprising equally sophisticated editing and formatting 
functions. 

The most important feature of all is 'User 
Friendliness'. In general, the easier it is for you to 
use the word processing program i.e. the less cryptic 

Figure 1.6 Document 1 is re-margined with Para Indents and 
Line Indents of 5 characters and a Line Width of 
60 characters. 
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1.9.3 Sticky Spaces 

A sticky space is one which will not be filled during 
formatting (See Lesson 10). It is produced by pressing the 
Open Apple key in conjunction with the space bar. Sticky 
spaces are shown on the screen by the S P symbol. Try 
producing a few! Sticky spaces are treated by Stemwriter as 
though they were alphabetical characters constituting a 
word, but are printed as spaces. Their usage ranges from 
leaving space for subsequent insertions, to ensuring that 
numbered paragraphs with hanging indents are handled 
correctly. Specifically, spaces following the number should 
be sticky spaces. 
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2.0 LESSON 2 - THE FIND/REPLACE/VERIFY OPERATIONS 

Preparation ; This Lesson requires that the file, 

/MYTEXT/EX.DOC.1, be in Document 1 of your computer's 
memory. If you are continuing on from Lesson 1, this will 
already be the case. If not, do the following; 

Ensure that your user diskette, /MYTEXT, is in the boot 
drive of your Apple //e or //c and load the file, 
/MYTEXT/EX.DOC.1, into Document 1 of your computer's memory. 
To do this, position the cursor in Document 1 by pressing 
Closed Apple 9 and adjusting the command line to read: 

Display :: Window [A] : Document [1] 

Press RETURN. To clear any existing Document 1, press Open 
Apple DELETE and adjust the command line to read; 

Clear Document [1] 

Press RETURN. You will now be asked to select the Para 
Indent, Line Indent and Line Width settings in the following 
command line: 

Line : Para Indent [5 3 Line Indent [£ 3 Line Width [72 3 

Don't worry about these settings too much, as they will be 
replaced by the Para Indent, Line Indent and Line Width 
information saved as part of the file, /MYTEXT/EX.DOC.1. 
So, press RETURN. 

To load the file, /MYTEXT/EX.DOC.1, press Closed Apple 
7 and adjust the command line to read: 

[Lead] [vtole] File [without] Encryption and [with I Backup 

Press RETURN. You must now display in this command line, 
the pathname of the file to be loaded. If you are 

continuing on from Lesson 1, the prefix /MYTEXT will be 
preset, as follows: 

Path[/MYTEXT ] 

If this is the case, skip the next two steps. If any other 

prefix is displayed, press the left arrow key (a destructive 
backspace) until the pathname is clear: 

Patht 3 


Lesson 2 





32 


Part 2 - Tutorial 


Press the down arrow key until the command line reads: 

Path[/MYTEXT ] 


Press the right arrow key once, and press the up/down arrow 
keys until EX.DOC.1 is displayed in the second position of 
the file pathname as follows: 

Patht/MYTEXT/EX.DOC.1 ] 


Now press RETURN to effect the loading of the file, 
/MYTEXT/EX.DOC.1, into Document 1. 

If you have just loaded/MYTEXT/EX.DOC.1, the cursor 
will automatically be positioned at the head of the 
document. Otherwise, you will need to move the cursor to 
the document head (press Closed Apple 8, etc). 

You can FIND or REPLACE all or a defined number of 
occurrences of a particular word or string of characters, 
using the Find/Replace/Verify command. Press the Open Apple 
key in conjunction with 8 to display the following command 
line: 

[Find ] designated word/string 


The full options for this command line are: 

[Find ] designated word/string 
[Replace] 

[Verify ] 

By pressing the up/down arrow keys, you may confirm these 
options. 

2.1 Finding a Designated Word/Strinq 

To Find a particular word or string of characters in a 
document without replacing them, adjust the command line to 
read: 

[Find ] designated word/string 


Press RETURN. All possible options of this command line, 
with the default options shown in the top line, are: 
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Srch :: Dir [>] : Count [1^ ] : Bound [Para ] : Case [Exact] : Mode [Lit ] 
[<] [All] [Doc. ] [Any ] [Word] 

[Chr: ] [Not =] 

Reading from left to right, this command line 
(including all of its options) reads: 

Search in the forwards or backwards direction. For the Find 
option, 'Count* is the particular occurrence of the 
word/literal string where the Find stops, e.g. [All] finds 
the last occurrence, and [4 ] would find the fourth 

occurrence. For the Replace/Verify option, 'Count' is the 
number of matchings to be considered for replacement. The 
search may be bounded to the current paragraph, the end of 
the document, or a designated character. You can search for 
any case, a case mismatch (the case is not the same as that 
in the designated word/string) or the exact case. You can 
search in the Word or Literal string mode. In Word mode, 
Stemwriter will find 'and', and only 'and', but in Literal 
mode, it would find 'ampersand', and 'handle' as well. 
Stemwriter recognizes punctuation as well as spaces, as 
being word delimiters. 


Adjust the command line to show the search options you 
want, e.g. 


Srch :: 

Dir [>] 

: Count[1 

, ] : 

Bound[Doc.] : Case[Any ] 

: Mode[Word] 

Press 

RETURN 

to accept 

these options. The 

command line 

should now read: 




F [ 





] 

You must now 

insert 

the 

word/string (up to 

70 characters 

long) 

to be searched 

for, 

inside the square brackets in the 

command line. 

e.g. 




F [Stemwriter 




] 


When you have done this, press RETURN. The Stemwriter 
program now searches in the forwards direction, until it 
Finds the first occurrence of 'Stemwriter' in Document 1. 
Thus, you can use the Find command to quickly find a 
particular place in your document. 
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If Stemwriter can't Find the designated word/string, 
you will get the message: 

No Match found <Cont. on SPACE bar> 

When you press the space bar, the current FIND operation 
ceases, and the cursor is returned to its former position in 
Document 1. 

2.2 Replacing a Designated Word/Strinq 

Suppose you want to Find the word 'command' and 
automatically replace every occurrence of it with the new 
text, 'COMMAND'. Since you previously found 'Stemwriter', 
which occurs near the end of Document 1, move the cursor to 
the tail of Document 1 (press Closed Apple 8, etc) and 
search for the next word in the reverse direction. To 
commence the Replace operation, press Open Apple 8 and 
adjust the command line to read: 

[Replace] Designated Word/String 

Press RETURN and adjust the command line to show the 
following Search options: 

Srch :: Dir[<] : Count[All ] : Bound[Doc.J : CaselAny ] : ModetLit ] 

When these options are displayed in the command line, press 
RETURN. The command line will now read: 

F [ 1 

Insert the word/string (up to 70 characters long) to be 
searched for, inside the square brackets in the command 
line. For example, 

F [command J 

Press RETURN. The Stemwriter program now asks you for the 
Replace word/string in the following command line: 

R [ 1 

Insert the Replace word/string (again up to 70 characters 
long) inside the square brackets in this command line, as 
follows: 

R [COMMAND 3 
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Press RETURN. The Stemwriter program now automatically 
Replaces the two occurrences of the literal string, 
'command' with the new string, 'COMMAND', viz: 'commands' 
and 'command' become 'COMMANDS' and 'COMMAND' respectively. 

2.3 Verify Replace a Designated Word/Strinq 

Jump to the head of the document. (That's right, press 
Closed Apple 8, etc). This time, we will find a 
word/string, and then decide whether to replace it or not. 
To start, press Open Apple 8 and adjust the command line to 
read: 

[Verify ] designated word/string 

Press RETURN and adjust the command line to read: 

Srch :: Dir[>] : Count[All] : Bound[Doc. ] : Case[Any ] : Mode[Word3 

When these Verify Search options are displayed in the 
command line, press RETURN. The command line will now read: 

F [ ] 

Insert the word/string (up to 70 characters) to be searched 
for, inside the square brackets in the command line, e.g. 

F [word ] 

Press RETURN. The command line will now read: 

R [ ] 

Insert the Replace word/string (again up to 70 characters) 
inside the square brackets in the command line, as follows: 

R [WORD ] 

Press RETURN. The cursor is now be positioned on the first 
occurrence of 'word' (Figure 2.1) and the command line will 
read: 


Replace the Match <esc>/Y/N: 

If you want to replace this occurrence of 'word' , type 
Y, if not, type N. The cursor is now automatically moved to 
the second occurrence of the designated Verify Replace 
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Replace the Match <esc>/Y/N 


The preparation of documents can often be a 

tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of time and effort required for these 
types of tasks. With the widespread introduction of 
microcomputers in the late 1970's, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcomputers could become very useful tools 
for many tasks including document preparation. 

So began the introduction of the first 

microcomputer based word processing programs. There are now 
many word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

The most important feature of all is 'User 
Friendliness'. In general, the easier it is for you to use 

Figure 2.1 Verify/Replace the first occurrence of 'word'. 

word/string, 'word'. You choose whether or not to replace 
each occurrence of 'word' by typing Y or N until all 
occurrences have been investigated. If you wish to escape 
from this command at any stage during the Verify Replace 
sequence, press ESCAPE (upper lefthand corner of the 
keyboard). 

Note : You may exit any Stemwriter command by pressing 

ESCAPE. 

2.4 Wildcard Word Search 


When searching in the WORD mode rather than the LITERAL 
mode, there are 3 wildcard word search options. You can 
search for all words with: An unspecified prefix; An 
unspecified suffix; Or an unspecified prefix and suffix. • A 
particular wildcard word search option is specified when you 
enter the designated Find/Replace word/string in the command 
line. The wildcard is specified by the carat symbol in the 
Find string as follows: 
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Wildcard prefix F ["ceive ] 
Wildcard suffix F [help* ] 
Wildcard prefix and suffix F [*err~ ] 

The specified Replace characters will replace only the 
characters searched for. Thus, when searching for all words 
with a particular suffix using the Verify option, for 
example, it is possible to selectively change the old suffix 
to a new one. 

To illustrate the wildcard word search options, move 
the cursor to the head of the document (press Closed Apple 
8, etc). We shall view all words with the suffix 'ing' and 
selectively replace them with the suffix 'or'. Press Open 
Apple 8, and adjust the command line to read: 

[Verify ] designated word/string 


Press RETURN and adjust the next command line to read: 
Srch :: Dir[>] : Count[All] : Bound[Doc.] : CaselAny ] : ModefWbrd] 


Press RETURN. The command line will now read: 

F [ ] 


Insert the wildcard word to be searched for, viz: 


F Ping 





] 


Press RETURN. 

This 

command 

line 

tells the 

Stemwriter 

program 

command 

to search 
line will 

for 

now 

all words 
read: 

with 

the suffix 1 

1 ing'. The 

V [ 





1 



Insert the Verify/Replace suffix inside the square brackets 
in the command line, as follows: 

V [or ] 


Press RETURN. The cursor will now be positioned on the 
first word ending in 'ing' in Document 1, i.e. 'involving' 
and the command line will read: 

Replace the Match <esc>/Y/N: 
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Press N for no replacement. The cursor will now be 
positioned on 'looking'. Again press N for no replacement. 
The cursor will be successively positioned on the following 
words: 'reducing, enterprising, including, processing, 
processing, varying, formatting, comprising, editing, 
formatting, processing, designing, writing, processing, 
processing, editing, formatting, having' and you will be 
asked whether to replace the match in each case. Press 'Y' 
to replace 'ing' with 'or' in the words: 'processing, 
editing', to obtain the words 'processor' and 'editor'. 

2.5 Special Characters 

Occasionally, you may need to find or replace special 
characters. To do this, it is necessary to enter the code 
for the special keys into the Find or Replace command 
strings. The following keystrokes are recognised: 


Keystroke 


Meaning 


Open Apple Return 
Closed Apple Return 
Control - L 


New Paragraph 
New Line 
New Page 
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3.0 LESSON 3 - BLOCK AND COLUMN OPERATIONS 


Preparation: This Lesson requires that the file, 
/MYTEXT/EX.DOC.1, be in Document 1 of your computer's 
memory. If you are continuing on from Lesson 2, this will 
already be the case. If not, do the following: 

Ensure that your user diskette, /MYTEXT, is in the boot 
drive of your Apple //e or //c and load the file, 
/MYTEXT/EX.DOC.1, into Document 1 of your computer's memory. 
To do this, position the cursor in Document 1 by pressing 
Closed Apple 9 and adjusting the command line to read: 

Display :: Window [A] : Document [1] 

Press RETURN. To clear any existing Document 1, press Open 
Apple DELETE and adjust the command line to read: 

Clear Document!1] 

Press RETURN. You will now be asked to select the Para 
Indent, Line Indent and Line Width settings in the following 
command line: 


Line : Para Indent [5 ] Line Indent [£ ] Line Width [72 ] 

Don't worry about these settings too much as they will be 
replaced by the Para Indent, Line Indent and Line Width 
information saved as part of the file, /MYTEXT/EX.DOC.1. 
So, press RETURN. 

To load the file, /MYTEXT/EX.DOC.1, press Closed Apple 
7 and adjust the command line to read: 

[Load] [Whole] File [without] Encryption and [with ] Backup 

Press RETURN. You must now display in this command line, 
the pathname of the file to be loaded. If you are 
continuing on from Lesson 2, the prefix /MYTEXT will be 
preset, as follows: 

Path[/MYTEXT ] 

If this is the case, skip the next two steps. If any other 
prefix is displayed, press the left arrow key (a destructive 
backspace) until the command line reads: 
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Patht 

] 

Press the down arrow key until the command 

line reads: 

Path[/MYTEXT 

] 

Press the right arrow key once, and then 

using the up/down 

arrow keys in the usual way, adjust the second position of 

the file pathname to read: 


Path[/MYTEXT/EX.DOC.1 

] 


Press RETURN. The file, /MYTEXT/EX. DOC. 1, will now be 
loaded into the computer's memory as Document 1. 


The Stemwriter program provides two methods for 
operating on sections of text. The BLOCK operation may be 
used to operate on characters, words, sentences, paragraphs, 
groups of paragraphs and whole documents. The COLUMN 
operations may be used to operate on tabulated data, such as 
tables of numbers. Both operations enable you to 
COPY/MOVE/WIPE the specified portion of the document. 

To select the BLOCK/COLUMN Operations command, press 
Open Apple with the 2 key. The full set of options 
available for this command are as follows: 

[Copy] text by [Block ] 

[Move] [Column] 

[Wipe] 

3.1 Block Operations 

Blocks of text may be MOVED, COPIED and DELETED. The 
text blocks may be as small as one character or as large as 
the whole document. Moving and Copying text from one part 
of a document to another or between different documents is 
not at all difficult because the Stemwriter program allows 
up to 8 documents to reside simultaneously in the computer's 
memory. The split screen facility allows you to display the 
document containing the text to be moved or copied in one 
window, and the destination document in another window. 

3.1.1 Moving And Copying Text Blocks 

This exercise involves COPYING the second sentence, 

beginning 'In general, the easier.', from paragraph 3 

of Document 1 to the end of Document 1. 
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Adjust the command line to read: 


[Copy] 

text 

by 

[Block] 

Press 

RETURN 

• 

The command line will now read: 

[Copy] 

Text 

by 

[Block] Move Cursor to Marker #1 and set. 


Move the cursor to the space immediately preceding the head 
of sentence 2 in paragraph 3 and mark this position by 
pressing Closed Apple 2 once. A marker will now be 
displayed at this position in the text (Figure 3.1) and the 
command line will read: 

Marker #1 Now set :: Move Cursor to Marker #2 and set 


Marker #1 Now set :: Move Cursor to Marker #2 and set 
many ward processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages ccrrprising equally 
sophisticated editing and formatting functions. 

The most important feature of all is 'User 
Friendliness'. Bln general, the easier it is for you to use 
the word processing program i.e. the less cryptic its 
conmands and the more it resembles the natural way of doing 
things with a pencil and paper, the more effort has gone 
into designing and writing the word processing program. 

The best word processing programs have many 
editing and formatting features but they do not require you 
to memorize than all. Instead they allow you to 'see and 
point' at the command options you want rather then having to 
'remember and type' them. It is this philosophy which is 
embodied in the Stemwriter program. 

Figure 3.1 Copy Marker 1 Set in Document 1. 


You must now mark the end of the text block to be 
Copied. Move the cursor to the end of paragraph 3 and press 
Closed Apple 2 again. A second marker is now displayed at 
this position in the text (Figure 3.2) and all text between 
the two markers may now be Copied. The command line will 
now read: 


Lesson 3 




42 


Part 2 - Tutorial 


Marker #2 now set :s Move cursor to Copy/Move destination 


Marker #2 now set :: Move cursor to Copy/Move destination 
many word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

The most important feature of all is 'User 
Friendliness'. Bln general, the easier it is for you to use 
the word processing program i.e. the less cryptic its 
commands and the more it resembles the natural way of doing 
things with a pencil and paper, the more effort has gene 
into designing and writing the word processing program.* 

The best word processing programs have many 
editing and formatting features but they do not require you 
to memorize than all. Instead they allow you to 'see and 
point' at the command options you want rather then having to 
1 remember and type' them. It is this philosophy which is 
embodied in the Stemwriter program. 

Figure 3.2 Copy Marker 2 Now Set in Document 1 


You must now mark the destination for the marked text block. 
Move the cursor to the end of Document 1 using the Jump 
command. That's right, press Closed Apple 8 and adjust the 
command line to read: 

Jump to Doc. [Tail] 

Press RETURN. Press Closed Apple 2 for a third time. The 
marked block of text is now automatically Copied to the end 
of the document (Figure 3.3). 


Note that the copied text is re-margined in its new 
position, and that the Copy Markers are still in place in 
paragraph 3. This allows repeated Copying of the same 
marked block of text. To copy the marked sentence in 
paragraph 3 a second time, move the cursor to the end of 
Document 1, press Closed Apple 1 to begin a new paragraph, 
and press Closed Apple 2 to effect the second copy. You can 
do this as many times as you like, provided the Copy Markers 
remain in place. To remove the Copy markers, press Open 
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The best ward processing programs have many editing and 
formatting features but they do not require you to memorize 
them all. Instead they allow you to 'see and point' at the 
command options you want rather then having to 'remember and 
type' then. It is this philosophy which is anbodied in the 
Stenwriter program. 

This is the end of Exanple Document 1. 

In general, the easier it is for you to use the 
word processing program i.e. the less cryptic its commands 
and the more it resembles the natural way of doing things 
with a pencil and paper, the more effort has gone into 
designing and writing the word processing program. 

Figure 3.3 An exanple of copying text within a document. 

Apple 2 followed by ESCAPE. 

Try repeating this exercise using [Move] instead of 
[Copy]. When you move text, the position from which the 
text is taken is re-margined also. Lesson 3.2 describes how 
to MOVE/COPY a block of text from one document to another. 

3.1.2 Deleting Blocks Of Text 

This exercise involves deleting the third sentence, 

beginning 'With the widespread.' from paragraph 1 of 

Document 1. 

To Delete text, press Open Apple 2 and adjust the 
command line to read: 

[Wipe] Text by [Block] 


Press RETURN. The command line will now read: 

[Wipe] Text by [Block] Move Cursor to Marker #1 and set 

Move the cursor to the head of the third sentence in 
paragraph 1. Press Closed Apple 2 once. A marker will now 
be displayed at this position in the text and the command 
line will read: 

Marker #1 Now set :: Move Cursor to Marker #2 and set 
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Move the cursor to the end of paragraph 1 and press Closed 
Apple 2 again. A second marker will now be displayed in the 
text and the text between the two markers may be WIPED 
(Figure 3.4). 


Marker #2 new set :: Ready to delete marked text 

The preparation of documents can often be a 

tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of time and effort required for these 
types of tasks. BWith the widespread introduction of 
microcomputers in the late 1970' s, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcomputers could become very useful tools 
for many tasks including document preparation.* 

So began the introduction of the first 

microcomputer based word processing programs. There are now 
many ward processing programs to choose from, varying in 
sqphistication from the mast rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

Figure 3.4 Markers in place to delete block of text. 

When the two markers are set, the command line will read: 

Marker #2 Now set :: Ready to delete marked text 

Now press Closed Apple 2 again. The marked text block is 
immediately deleted by the Stemwriter program (Figure 3.5). 

You can 'UNDELETE' the text at this point by pressing 
ESCAPE as the message displayed in the command line tells 
you: 

<esc> will Unwipe 

N.B : To 'Undelete' text, you must do so before you select 

any other Stemwriter command, i.e. while the 'Undelete' 
message is still in the command line, otherwise the text 
will be lost. 

3.2 Block Operation Example 

To re-inforce the foregoing description of block 
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<esc> will Unwipe 

The preparation of documents can often be a 
tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of time and effort required for these 
types of tasks. 

So began the introduction of the first 
microcarputer based ward processing programs. There are new 
many word processing programs to choose from, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages comprising equally 
sophisticated editing and formatting functions. 

The most important feature of all is 'User 
Friendliness'. In general, the easier it is for you to use 
the word processing program i.e. the less cryptic its 
commands and the more it resembles the natural way of doing 
things with a pencil and paper, the more effort has gone 
into desinging and writing the word processor program. 

Figure 3.5 Marked text is new deleted from Document 1. 

operations, work through the next example. Some initial 
preparation is necessary. Ensure that a complete copy of 
the file, /MYTEXT/EX.DOC.1, is loaded into Document 1. 
Proceed as follows: 

Position the cursor in Document 1 if it is not there 
already, by pressing Closed Apple 9 and adjusting the 
command line to read: 

Display :: Window [A] : Document [1] 


Press RETURN. To clear the existing Document 1, press Open 
Apple DELETE and adjust the command line to read: 


Clear Document!1] 





Press RETURN. You will now be asked to select 

the Para 

Indent, Line Indent and 
command line: 

Line 

Width settings in 

the 

following 

Line : Para Indent [j> ] 

Line 

Indent [0 ] Line 

Width [72 ) 


Don't worry about these settings too much as they will be 
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replaced by the Para Indent, Line Indent and Line Width 
information saved as part of the file, /MYTEXT/EX.DOC.1. 
So, press RETURN. 

To load the file, /MYTEXT/EX.DOC.1, into the computer's 
memory, press Closed Apple 7 and adjust the command line to 
read: 

[Load] [Whole] File [without] Encryption and [with 3 Backup 

Press RETURN. The pathname will probably show the prefix 
/MYTEXT, already in place in the command line as follows: 

Pathl/MYTEXT ] 

If not, press the left arrow (a destructive backspace) to 
clear any other prefix and press the down arrow key until 
you obtain: 

Path[/MYTEXT ] 

Press the right arrow key once, and then using the up/down 
arrow keys, adjust the second position in the pathname to 
read: 

Pathl/MYTEXT/EX.DOC.1 ] 

Press RETURN. The file, /MYTEXT/EX. DOC. 1, will now be 

loaded into the computer's memory as Document 1. 

Now move the cursor into Document 2 of the computer's 
memory and load the file, /MYTEXT/EX.DOC.2, in a similar 
manner to that described above for /MYTEXT/EX.DOC.1. After 
you have loaded the file, /MYTEXT/EX.DOC.2 into Document 2, 
move the cursor back into Document 1 as follows: 

Press Closed Apple 9 and adjust the command line to read: 

Display :: Window [A] : Document [1] 

Press RETURN. 

The purpose of this example is to delete paragraph 3 

(starting "The most important feature .") of Document 

1, and replace it by paragraphs 2 and 3 of Document 2. The 
first step is to delete paragraph 3 from Document 1. To do 
this, press Open Apple 2 and adjust the command line to 
read: 
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[Wipe] Text by [Block] 

Press RETURN. The command line will read: 


[Wipe] Text by [Block] Move Cursor to Marker #1 and set 

Move the cursor to the head of paragraph 3 and place a 
marker at this point by pressing Closed Apple 2 once. The 
command line will now read: 


Marker #1 now set :: Move cursor to Marker #2 and set 

Move the cursor to the head of paragraph 4 by pressing 
Closed Apple 1 once. Place the second marker in the text at 
this point by pressing Closed Apple 2 again. The command 
line will now read: 


Marker #2 now set :: Ready to Delete marked text. 

Press Closed Apple 2 for the third time and the marked 
paragraph will disappear (Figure 3.6). 


<esc> will Unwipe 

The preparation of documents can often be a 
tedious and laborious process involving several draft 
stages. This is a good reason for looking for ways of 
reducing the amount of tine and effort required for these 
types of tasks. With the widespread introduction of 
microcanputers in the late 1970's, many enterprising 
individuals recognized that with a suitable set of 
instructions, microcanputers could become very useful tools 
for irony tasks including document preparation. 

So began the introduction of the first 
microcomputer based word processing programs. There cure now 
many word processing programs to choose fran, varying in 
sophistication from the most rudimentary line oriented text 
editors with minimal formatting capabilities, to the very 
advanced integrated software packages canprising equally 
sophisticated editing and formatting functions. 

Figure 3.6 Paragraph 3 deleted from Document 1. 

The command line will show the message: 
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<esc> will Unwipe 


If you press ESCAPE at this point, the deleted text will be 
Undeleted. 

To move paragraphs 2 and 3 from Document 2 into 
Document 1, firstly position the cursor in Document 2 as 
follows: Press Closed Apple 9 and adjust the command line 

to read: 

Display :: Window [B] : Document [2] 

Press RETURN. Document 2 will now be displayed in the top 
half of the screen only. Press Open Apple 2 and adjust the 
command line to read: 

[Move] Text by [Block] 

Press RETURN. The command line will read: 

[Move] Text by [Block] Move Cursor to Marker #1 and set 

Move the cursor to the head of paragraph 2 and insert the 
first marker by pressing Closed Apple 2 once. The command 
line will now read: 

Marker #1 now set :: Move cursor to Marker #2 and set 

Move the cursor to the head of paragraph 4 by pressing 
Closed Apple 1, twice. Insert the second marker at this 
point by pressing Closed Apple 2 again. The command line 
will now read: 

Marker #2 now set :: Move cursor to Copy/Move destination 

Move the cursor back into Document 1 by pressing Closed 
Apple 9 and adjusting the command line to read: 

Display :: Window [C] : Document [1] 

Press RETURN. The text to be moved will now be displayed' in 
the top half of the screen and the destination document in 
the lower half of the screen (Figure 3.7). 


Lesson 3 






Part 2 - Tutorial 


49 


Marker #2 now set :: Move cursor to Copy/Move destination 

We are faced many tines with the need to 'cannibalize' parts of one 
document and place the pieces in a second document. The following two 
paragraphs have been designed for use in this kind of exercise: 

■ The effective power of a word processor is set by its inherent 
capability, i.e. what it is capable of doing, and its ease of use, often 
called its measure of 'User Friendliness'. It is oily recently that the 


The best word processing programs have many 
editing and formatting features but they do not require you 
to memorize them all. Instead they allow you to 'see and 
point' at the comnand options you want rather then having to 
' remember and type' than. It is this philosophy which is 
embodied in the Stemwriter program. 

This is the aid of Exaiqple Document 1. 

Figure 3.7 Document 2 is in the top half of the screen and 
Document 1 is in the bottom half of the screen. 

Move the cursor to the head of the paragraph beginning 

"The best word processing .", and press Closed Apple 2 

again to mark the position for the text to be moved to. 

Paragraphs 2 and 3 of Document 2 will now be moved from 
Document 2 into Document 1 (Figure 3.8). 

Scroll through Document 1 in the lower window (Window C) . 
Now move the cursor into Document 2 in the upper window 

(Window B) and scroll through it to confirm that paragraphs 
2 and 3 have indeed been moved. 

Note that as well as moving the paragraphs, Stemwriter 
has also re-calculated the line breaks from the insertion 

point to the beginning of the next paragraph. This is 

because after any cut/paste, block move, copy or wipe 
operation, re-margining occurs automatically from the first 
marker until an unambiguous line break is reached. 
Consequently, the second moved paragraph is unaltered and 
paragraph indentations have not been re-calculated. 

To globally re-margin Document 1, press Open Apple 9 
and adjust the command line to read: 

Set Global data for [Line] break calculation 
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We are faced many times with the need to 'cannibalize' parts of one 
docunent and place the pieces in a second document. The following two 
paragraphs have been designed for use in this kind of exercise: 

Today, the intending user has a veritable 'feast' of carpeting Word 
Processing packages to choose from, each with its unique contribution to 
the art of User Interface design. 

The effective power of a word processor is set by 
its inherent capability, i.e. what it is capable of doing, 
and its ease of use, often called its measure of 'User 
Friendliness'. It is only recently that the vital 
importance of ease of use has been recognized. Capabilities 
which are hard, or confusing to use will rarely be used, and 
may as well not be present. As we are all familiar with 
'pencil and paper', it would seen that the closer a User 

Figure 3.8 Paragraphs 2 and 3 moved from Document 2 into 
Document 1. 


Press RETURN. Adjust the next command line to show the Para 
Indent, Line Indent and Line Width values you want for the 
whole of Document 1 as follows: 

Line : Para Indent [10] Line Indent [£ ] Line Width [60 ] 

Press RETURN. After a short pause, Document 1 will be 
completely re-margined (Figure 3.9). 


To [Copy] the two paragraphs from Document 2 instead of 
moving them, you should select 

[Copy] text by [Block] 

and then proceed in the same way as described above for 
[Move]. Try repeating this exercise using [Copy] instead of 
[Move]. You will need to re-start from the beginning of 
Lesson 3.2. When you have finished copying, remove the 
markers from the copy Document by pressing Op>en Apple 2 and 
then pressing ESCAPE. 
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The effective power of a word processor is set by 
its inherent capability, i.e. what it is capable of doing, 
and its ease of use, often called its measure of 'User 
Friendliness'. It is only recently that the vital 
inportance of ease of use has been recognized. Capabilities 
which are hard, or confusing to use will rarely be used, and 
may as well not be present. As we are all familiar with 
'pencil and paper', it would seem that the closer a User 
Interface approaches 'pencil and paper' simplicity, without 
sacrificing power and efficiency, the more successful it 
will be. 

Clearly, simplicity for the user must cost 
something. It costs blood, sweat and tears on the part of 
the program designer, and the programmers. It is a rule of 
thumb that 'sinple for the programmer' is 'obscure' for the 
general user, and vice-versa. Another problem is that a 
good User Interface seems to consume substantial Computer 
Memory. 

Figure 3.9 Document 1 is globally re-margined with a 
Paragraph Indent of 10 and a Line Width 
of 60 characters. 

Remember, Copy Markers, once inserted, stay in place 
until removed. This allows repeated copying of the same 
marked block of text. 

3.3 Column Operations 

Document 3 should be clear at this stage. To position 
the cursor in Document 3, press Closed Apple 9 and adjust 
the command line to read; 

Display Window [A] : Document 13] 

Press RETURN. If Document 3 was indeed empty, the command 
line will read: 

Line : Para Indent [5^ ] Line Indent [£ ] Line Width 17.2 3 

Press RETURN. 

Ensure that your user diskette, /MYTEXT, is in the boot 
drive of your Apple //e or //c and load the file 
/MYTEXT/TABLE into the computer's memory as Document 3. To 
do this, press Closed Apple 7 and adjust the command line to 


Lesson 3 




52 


Part 2 - Tutorial 


read: 

{Load] [Whole] Pile [without] Encryption and [with ] Backup 

Press RETURN. Adjust the Pathname command line using the 
arrow keys in the usual way, to read: 

Path[/MYTEXT/TABLE ] 

Press RETURN. The file, /MYTEXT/TABLE, will now be loaded 
into Document 3 where it will be used to demonstrate Column 
Operations. 

For Column operations, the two markers designating the 
chosen column must be set at the diagonals of a rectangle 
enclosing the column. You may use either the upper left and 
lower right corners, or the lower left and upper right 
corners. It doesn't matter which, as long as they are 
diagonally placed to encompass the entire column to be 
moved. When Copying or Moving a column, the destination 
marker always defines where the upper left corner of the 
Copied/Moved column will be. 

The placement of the column definition markers exactly 
parallels the placement of the Block definition markers. 
The only difference is in how they are interpreted by the 
Stemwriter program. 

Try moving Column 1 in Document 3 to a position between 
Columns 3 and 4. Press Open Apple 2 and adjust the command 
line to read: 


[Move] text by [Column] 

Press RETURN. The command line will read: 

[Move] text by [Column] Move cursor to Marker #1 and set 

Move the cursor to a position just to the left of the words 
'COL 1' and press Closed Apple 2 to set a marker at this 
position. The command line will now read: 

Marker #1 now set :: Move cursor to Marker #2 and set 


Move the cursor to the last row of the Table, and position 
the cursor between the figures of columns 1 and 2, ensuring 
that the whole of the heading 'COL 1' is encompassed by the 
markers. Press Closed Apple 2 to set this second marker. 
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Column 1 should now be enclosed by a rectangle defined by 
the set markers (Figure 3.10) and the command line will 
read: 


Marker #2 Now set :: Move Cursor to Copy/Move Destination 


Marker #2 now set :: Move cursor to Copy/Move Destination 

A SAMPLE TABLE 


ODL 0 

■ COL 1 

COL2 

COL 3 

COL 4 

COL 5 

COL 6 

12.34 

11 

12 

13 

14 

15 

16 

442.1 

21 

22 

23 

24 

25 

26 

1.23 

31 

32 

33 

34 

35 

36 

4.45 

41 

42 

43 

44 

45 

46 

445.2 

51 

52 

53 

54 

55 

56 

2.221 

61 

62 

63 

64 

65 

66 

3.185 

71 

72 

73 

74 

75 

76 

313.21 

81 

82 

83 

84 

85 

86 

3.001 

91 

92 

93 

94 

95 

96 

221.4 

01 ■ 


03 

04 

05 

06 


Figure 3.10 Markers in position enclosing Column 1. 


Move the cursor to the top line of the Table, and position 
it between the headings 'COL 3' and 'COL 4'. Press Closed 
Apple 2 a third time to complete the operation. 'COL 1' 
will now be positioned in the Table between 'COL 3' and 
'COL 4' (Figure 3.11). 


3.4 Inserting A Number In A Column Of Figures 

If you discover that ypu have accidently left a number 
out of a column of figures, it is not too difficult to 
insert the omitted number in its correct position in the 

column. 

If you are following on from Lesson 3.3, the file, 
/MYTEXT/TABLE, will already be loaded into Document 3 of the 
computer's memory. If not, load this file now, as described 

at the beginning of Lesson 3.3. You will notice that 'COL 

2' has one fewer entry than the other columns. Try 

inserting the number 48 in 'COL 2' between the numbers 42 
and 52. 
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A SAMPLE TABLE 




OOL 0 

00L2 

COL 3 

COL 1 

COL 4 

COL 5 

COL 6 


12.34 

12 

13 

11 

14 

15 

16 


442.1 

22 

23 

21 

24 

25 

26 


1.23 

32 

33 

31 

34 

35 

36 


4.45 

42 

43 

41 

44 

45 

46 


445.2 

52 

53 

51 

54 

55 

56 


2.221 

62 

63 

61 

64 

65 

66 


3.185 

72 

73 

71 

74 

75 

76 


313.21 

82 

83 

81 

84 

85 

86 


3.001 

92 

93 

91 

94 

95 

96 


221.4 


03 

01 

04 

05 

06 


Figure 3.11 

Column 1 is new 

positioned between columns 3 and 4. 


To enter 

a number in 'COL 2' 

immediately below 

42, 

position 

the cursor on 

the 4 

in 42 and 

cut the text 

by 

pressing 

Closed Apple 

0 once. 

Now 

enter 

two spaces (the 

width of 

the 

omitted 

number) 

by pressing the space 

bar 

twice. Paste 

the text 

by pressing Closed Apple 0 again 

and 

move the 

cursor two positions 

to the 

left. 

i.e. until it 

is 

below the 

3 in 

the number 32 (Figure 

3.12). 






A SAMPLE TABLE 




COL 0 

00L2 

COL 3 

COL 1 

COL 4 

COL 5 

OOL 6 


12.34 

12 

13 

11 

14 

15 

16 


442.1 

22 

23 

21 

24 

25 

26 


1.23 

32 

33 

31 

34 

35 

36 


4.45 

■ 42 43 

41 

44 

45 

46 


445.2 

52 

53 

51 

54 

55 

56 


2.221 

62 

63 

61 

64 

65 

66 


3.185 

72 

73 

71 

74 

75 

76 


313.21 

82 

83 

81 

84 

85 

86 


3.001 

92 

93 

91 

94 

95 

96 


221.4 


03 

01 

04 

05 

06 



Figure 3.12 Space being made bo insert a number in Column 2. 


You must now move 'COL 2* down one row of figures to make 
space for the omitted number. To do this, press Open Apple 
2 and adjust the command line to read: 


Lesson 3 





Part 2 - Tutorial 


55 


[Move] Text by 

[Column] 





Press RETURN. 

Press Closed Apple 

2 

to place a 

marker at 

this position. 

The command line 

will 

read: 


Marker #1 now 

set :: Move cursor 

to 

Marker #2 and 

set 


Move the cursor to the last row of the table so that it is 
positioned immediately below the 9 in 92 and delete two 
spaces. When you have done this move the cursor up one row 
in the table and position it immediately to the right of 2 
in 92. Press Closed Apple 2 to position the second marker 
at this point (Figure 3.13). 


Marker #2 

now set : 

: Move cursor to Copy/Move destination 

A SAMPLE TABLE 

CDL 0 

C0L2 

COL 3 

COL 1 

COL 4 

COL 5 

OOL 6 

12.34 

12 

13 

11 

14 

15 

16 

442.1 

22 

23 

21 

24 

25 

26 

1.23 

32 

33 

31 

34 

35 

36 

4.45 

■ 42 

43 

41 

44 

45 

46 

445.2 

52 

53 

51 

54 

55 

56 

2.221 

62 

63 

61 

64 

65 

66 

3.185 

72 

73 

71 

74 

75 

76 

313.21 

82 

83 

81 

84 

85 

86 

3.001 

92 ■ 

93 

91 

94 

95 

96 

221.4 


03 

01 

04 

05 

06 


Figure 3.13 Markers now in position to move part of Column 2 down 
one row of figures. 


The command line will now read: 


Marker #2 now set :: Move cursor to Copy/Move Destination 

Move the cursor back up this column of figures and position 
it on the 5 in 52. Now press Closed Apple 2 again. The 
marked portion of 'COL 2' is now moved down one row in the 
table and a space is made to insert the omitted number. 
Notice that the cursor is positioned ready for you to type 
the number 48 into its correct position in the table (Figure 
3.14). 
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A SAMPLE 

TABLE 



COL 0 

COL2 

COL 3 

COL 1 COL 4 

COL 5 

OOL 6 

12.34 

12 

13 

11 

14 

15 

16 

442.1 

22 

23 

21 

24 

25 

26 

1.23 

32 

33 

31 

34 

35 

36 

4.45 

42 

43 

41 

44 

45 

46 

445.2 

■ 

53 

51 

54 

55 

56 

2.221 

52 

63 

61 

64 

65 

66 

3.185 

62 

73 

71 

74 

75 

76 

313.21 

72 

83 

81 

84 

85 

86 

3.001 

82 

93 

91 

94 

95 

96 

221.4 

92 

03 

01 

04 

05 

06 


Figure 3-14 Column 2 of Table ready to accept omitted number. 


3.5 Removing Markers 

If you get part of the way through a Block or Column 
operation, and then wish to terminate it, or if you have 
been Copying text, and wish to remove the Markers, proceed 
as follows: 

:Press Open Apple minus on the Numeric Keypad 
:Press ESCAPE to deselect this operation 

The markers will now be removed and you will no longer be in 
the Copy/Move/Wipe command. 
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4.0 LESSON 4 - SETTING THE TABS 

The Stemwriter program allows you to set up to 16 
independent tab stops per document. At start-up, the 
default tabs are 8 columns apart beginning at column 8. If 
you prefer, you may clear these tabs, set new ones and 
display them at the top of the current screen window, if you 
so choose. 

Preparation ; If you are following on from Lesson 3, no 
preparation is necessary, as the file, /MYTEXT/TABLE, will 
still be in Document 3 of the computer's memory. If not, 
load the file, /MYTEXT/TABLE, into Document 3 of the 
computer's memory as described in detail at the beginning of 
Lesson 3.3. 

4.1 Showing Tabs 

To manipulate the tab positions, press Open Apple with 
the TAB key. The command line will read: 


[Set ] Tabs 

The cursor is positioned on [Set] and all permitted options 
of this command line are: 

[Set ] Tabs 
[Clear] 

[Show ] 

Confirm this by pressing the up/down arrow keys to show each 
option. When you have finished experimenting, adjust the 
command line to read: 


[Show] Tabs 

Press RETURN. The next command line will read: 

Tab Display [off] 

To display the tab stops at the top of the current window, 
press the down arrow key once to adjust the command line to 
read: 


Tab Display [on] 

Press RETURN. The five currently set tabs, each 8 columns 
apart, are now displayed as underline markings on a ruler at 
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the top of 

the 

current 

screen 

window 

(Figure 

4.1) . 

- : - : . . 


--i... 

A SAMPLE TABLE 



00L 0 

C0L2 

COL 3 

COL 1 

COL 4 

COL 5 

COL 6 

12.34 

12 

13 

11 

14 

15 

16 

442.1 

22 

23 

21 

24 

25 

26 

1.23 

32 

33 

31 

34 

35 

36 

4.45 

42 

43 

41 

44 

45 

46 

445.2 

48 

53 

51 

54 

55 

56 

2.221 

52 

63 

61 

64 

65 

66 

3.185 

62 

73 

71 

74 

75 

76 

313.21 

72 

83 

81 

84 

85 

86 

3.001 

82 

93 

91 

94 

95 

96 

221.4 

92 

03 

01 

04 

05 

06 


Figure 4.1 Example of tab stops displayed on a ruler at the top 
of the current screen window. 


4.2 Clearing Tabs 

Position the cursor at the head of the Table (that's 
right, press Closed Apple 8, etc). To clear two of the 
existing tabs, press Open Apple TAB and adjust the command 
line, in the usual way, to read: 

[Clear] Tabs 

Press RETURN. All possible options of the 'Set Tabs' 
command line, with the default options in the top line are 
as follows: 

Clear [All] Tab from Col [Csr] 

[1 ] tl ] 

The cursor is positioned on [All]. Press the down arrow key 
once to adjust the command line to read: 

Clear [j^ ] Tab from Col [Csr] 

As was previously stated, an underlined number in the 
command line means that you may enter a number at this 
position in the command line. Try it! Type 2, then press 
RETURN once to accept the new value in the command line. 
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The command line should now read: 

Clear [2 ] Tab from Col [Csr] 


Press RETURN. The Stemwriter program will now clear 2 tab 
stops beginning from the column in the text where the cursor 
is currently positioned. As the cursor is at the head of 
the Table, the first two tabs will be cleared. To clear the 
remainder of the Tabs, press Open Apple TAB and adjust the 
command line to read: 


[Clear] Tabs 

Press RETURN and adjust the 

command line to read: 

Clear [All] Tab from Col [.1 

] 


Press RETURN. All previously existing tab stops should now 
be removed from the ruler at the top of the current window. 

4.3 Setting Tabs 

Now that all previously existing tabs have been 
cleared, try setting some new ones. Press Open Apple TAB 
and adjust the command line to read: 

[Set] Tabs 

Press RETURN. The 'Set Tabs' command line has the following 
options with the default options shown in the top line. 

Set [All] Tab at Col [Csr] Step[j3 ] Align. Chr[^ 1 
[1 ] [1 ] 

The portion of the command line which reads 

Align. Chr [_^ ] 

allows you to enter a Tab Alignment Character inside the 
square brackets. The tab alignment character you choose is 
associated with every tab stop and is used in conjunction 
with the Column Alignment command. For example, if you 
entered a period as the tab alignment character, you could 
then align columns of figures on the decimal point. With an 
equals sign, you could align equations on the equals sign. 
The left or right bracket allows you to align brackets 
around numbers, etc. This alignment facility of the 
Stemwriter program will be discussed in more detail in 
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Lesson 5 (Column Alignment). If you leave [_^ J blank, the 
Stemwriter program ignores this part of the command line. 

Try entering the equals sign inside the square brackets 
associated with Align. Chr. Move the cursor so it is 
positioned on [j^ ]. The underline under the colon inside 

the square brackets indicates that you may enter a character 
at this position in the command line. Type the equals sign 
and accept it by pressing RETURN. The command line should 
now read: 

Set [All] Tab at Col [Csr] Step[8 ] Align. Chr [j_= ] 

To change the tab alignment character from the equals sign 
to the decimal point, place the cursor on [j^= ] in the 

command line, type the decimal point and press RETURN to 
accept the new tab alignment character. The command line 
should now read: 

Set [All] Tab at Col [Csr] Step[_8 ] Align. Chr (j. • ] 

The Stemwriter program allows you to set a specified 
number of tabs (up to 16 per document) beginning at a 
nominated column with a specified number of columns between 
each tab stop. Tabs can also be set individually at a 
particular cursor position. Position the cursor on [All] in 
the command line and adjust it to read: 

Set [1 ] Tab at Col [Csr] Step[8 ] Align. Chr [_:. 3 

This command line tells the Stemwriter program to set 1 tab 
at the column in the text where the cursor is currently 
positioned and associate the decimal point alignment 
character with this tab. 'Step' is ignored when only 1 tab 
is being set. 

Notice [1^ ] in the 'Set' position of the command line 

is underlined. This means you can enter a new value at this 
point in the command line. To set 6 tabs, type the number 6 
at the 'Set' position and accept the new value by pressing 
RETURN. The command line will now read: 


Set [6 ] Tab at Col [Csr] Step[8 ] Align. Chr [j_. ] 

This command line is telling the Stemwriter program to set 6 
tabs beginning at the column in the text where the cursor is 
positioned. The tabs are to be 8 columns apart and the 
decimal point tab alignment character is to be associated 
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with each of them. 

To set the tab stops from column 1, place the cursor on 
[Csr] in the command line and press the down arrow key once. 
The command line will now read: 

Set [6 ] Tab at Col [1 ] Step[8 ] Align. Chr [^. 1 

Similarly, to set the tabs from column 15, type 15 inside 
the Col [1 ] square brackets and press RETURN to accept the 

new value. The command line will now read: 

Set [6 ] Tab at Col [15 ] Step [8 ] Align. Chr [j_. ] 

To change the spacing between the tabs from 8 to 7 columns, 

place the cursor on Step [j3 ] in the command line, type 7 

and press RETURN to accept the new value. The command line 

will now read: 

Set [6 ] Tab at Col [15 ] Step [7 ] Align. Chr [ju ] 


Press RETURN. 

The Stemwriter program now sets 6 new tab stops, the 
first being positioned at column 15. The tabs are 7 columns 
apart and each is associated with the decimal point tab 
alignment character. The new tab positions are displayed on 
the ruler at the top of the current window as inverse video 
blocks in which the decimal tab alignment character is 
displayed (Figure 4.2). 


Note that the set tabs are permanently associated with 
the current document. Each of the eight documents 
Stemwriter can accommodate in memory has 16 independently 
settable tabs. When a document is saved as a file, the tab 
settings are saved also, and are restored when the document 
is once more loaded into memory. 

If you try to set more than 16 tabs in a document, the 
following message will appear in the command line: 

Not enough free Tabs <Cont. on SPACE bar> 

Pressing the space bar will return the cursor to its former 
position in the text. Notice that Stemwriter will have set 
as many of the tabs as it was able, in this case 16. 
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A SAMPLE TABLE 



00L 0 

COL2 

COL 

3 COL 1 

COL 4 

COL 5 

COL 6 

12.34 

12 

13 

11 

14 

15 

16 

442.1 

22 

23 

21 

24 

25 

26 

1.23 

32 

33 

31 

34 

35 

36 

4.45 

42 

43 

41 

44 

45 

46 

445.2 

48 

53 

51 

54 

55 

56 

2.221 

52 

63 

61 

64 

65 

66 

3.185 

62 

73 

71 

74 

75 

76 

313.21 

72 

83 

81 

84 

85 

86 

3.001 

82 

93 

91 

94 

95 

96 

221.4 

92 

03 

01 

04 

05 

06 


Figure 4.2 Exanple of Decimal Tab Stops. 
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5.0 LESSON 5 - ALIGNING TEXT 

Position the cursor in a clear document, e.g. Document 
4. Do this by pressing Closed Apple 9 and adjusting the 
command line to read: 


Display :: Window 

[A] 

: Document [43 



Press RETURN. The 

command line will 

now 

read: 

Line : Para Indent 

E5 

] Line Indent 

to 1 

Line Width [72 ] 


Press RETURN. 

To adjust the position of a line of text, or to align a 
column of figures without affecting adjacent columns, press 
Closed Apple 5. The two available options of the alignment 
command are: 

Align text by [Line ] 

[Column] 

5.1 Line Adjustment 

Type the following words: 

Line Adjustment is easy 

Press Closed Apple 5 and adjust the command line to 

read: 

Align text by [Line] 

Press RETURN. The command line will read: 

Line Adjust :: L(eft C(enter R(ight Arrows. Exit on <esc> 

To center the words 'Line Adjustment is easy', press C. The 
line is now automatically centered: 

Line Adjustment is easy 

Press R, and the line automatically finishes on the right 
margin: 

Line Adjustment is easy 
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Press L, and the line automatically starts at the left 
margin: 

Line Adjustment is easy 

Press the right arrow key a few times and observe the line 
of text move to the right one position for each press of the 
right arrow key. Similarly, press the left arrow key a few 
times and observe the line of text move towards the left 
margin. Now press the ESCAPE key to leave the LINE ADJUST 
command. If you have several lines of text to be Adjusted, 
e.g. Centered, proceed as follows: 

Initially, type the text to be adjusted, with each line 
starting at the left margin as follows: 

•Moving the cursor 
Through the text 
Can be done 
In many different 
Ways. ' 

When you have entered the text, the cursor will be 
positioned at the end of the text. Press Closed Apple 5 to 
select the LINE ADJUST command and press C to center the 
text. As the cursor is positioned in the last line of the 
text, it will now be centered: 

•Moving the cursor 
Through the text 
Can be done 
In many different 

Ways.' 

Press the up arrow key once to position the cursor in the 
second last line of the text and so it is now centered. 
Press the up arrow key three more times. As you do this, 
each line is successively centered. Press <esc> to exit the 
Line Adjust command. Your text will now appear as follows: 

'Moving the cursor 
Through the text 
Can be done 
In many different 
Ways.' 
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5.2 Column Adjustment 

The Column Alignment option works in conjunction with 
the SET TABS command. To use the Tab Alignment command to 
align a column of figures to the decimal point, or a series 
of equations to the equals sign, you must have previously 
associated the tab alignment character of interest, i.e. the 
decimal point, equals sign, etc, with the tabs. 

Tables containing columns of figures such as in the 
following example, are easy to prepare if you associate the 
decimal point alignment character with the tab stops. 

Clear Document 4. To do this, press Open Apple DELETE 
and adjust the command line to read: 

Clear Document [4] 

Press RETURN. The command line will read: 


Display :: Window 

[A] 

: Document [4 3 



Press RETURN. The 

command line will 

now 

read: 

Line : Para Indent 

[5 

] Line Indent 

CO 

] Line Width [72 ] 


Press RETURN. 


Initially there are 16 default tab stops, 8 columns 
apart, associated with this document in the computer's 
memory. The first tab is set at column 8 and the second at 
column 16. Before you type the numbers shown below into 
Document 4, clear the first tab. To display the tabs on a 
ruler at the top of the current window, press Open Apple TAB 
and adjust the command line to read: 

[Show] Tabs 

Press RETURN and adjust the next command line to read: 

Tab Display [on] 

Press RETURN. To clear the first tab, press Open Apple TAB 
and adjust the command line to read: 

[Clear] Tabs 

Press RETURN. The command line will read: 
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Clear [All] Tab from Col [Csr] 

Adjust this command line in the usual way to reads 

Clear [1 ] Tab from Col 18 ] 

Press RETURN. Now type the tabulated data shown below 
without regard to the decimal point positions with the first 
column of figures beginning at the left margin, and the 
second column of figures beginning at column 16, the first 
tab stop. 


1.321 

0.01 

11.463 

41.32 

121.41 

149.6 

0.62 

1.37 

191.4 

11.91 


When the two columns of figures have been entered, clear the 
existing tabs and set two decimal tab stops at columns 5 and 
20. To do this, press Open Apple TAB and adjust the command 
line to read: 

[Clear] Tabs 

Press RETURN and adjust the next command line to read: 

Clear [All] Tab from Col [1 ] 

Press RETURN. To set two tabs at columns 5 and 20, press 
Open Apple TAB and adjust the command line to read: 

[Set ] Tabs 

Press RETURN. The command line will read: 

Set [All] Tab at Col [Csr] Step [8] Align. Chr [:_] 

Adjust this command line, in the usual way, to read: 

Set [2 ] Tab at Col ££> ] Step [ 1_5 3 Align. Chr [ s^] 

This command line tells the Stemwriter program to set two 
decimal tabs, the first being at column 5 and the second at 
column 20 (5+15). 

Press RETURN. The decimal tab stops at columns 5 and 20 
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should now be displayed on the ruler at the top of the 
current screen window (Figure 5.1). 



.0.t.: 


1.321 

0.01 


11.463 

41.32 


121.41 

149.6 


0.62 

1.37 


191.4 

11.91 



Figure 5.1 TWo decimal tabs are set. 


For each column of figures, you must position the 
cursor on the decimal point in the first number to be 
aligned. This defines the character to be matched against 
the Tab Alignment Character. When you have done this, it is 
simply a matter of using the TAB ALIGNMENT command to align 
each column of figures to the decimal point. 

Select the TAB ALIGNMENT command by pressing Closed 
Apple 5 and adjusting the command line to read: 

Align text by [Column) 

Press RETURN. Adjust the command line to read one of the 
following permutations: 

Align chr to [Near ] Tab 
[Left ] 

[Right] 

Press RETURN. The number in which the cursor is positioned 
will align to the nearest, left or right tab (whichever you 
selected) and the command line will read: 

Up, Down Arrow Repeats <esc> Exits 

To align the next number in the column of figures to 
the decimal point, use the up/down arrow keys to move the 
cursor vertically to the next number to be aligned. As soon 
as you do this, the number is automatically aligned to the 
decimal point. Thus, an entire column of figures may be 
aligned very quickly without disturbing adjacent columns 
(Figure 5.2). When alignment of the first column is 
complete, press ESCAPE to exit this command. 
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_EL...:. 



1.321 

0.01 


11.463 

41.32 


121.41 

149.6 


0.62 

1.37 


191.4 

11.91 



Figure 5.2 The first coluim of figures is aligned to the 

decimal tab without disturbing the second oolurm 
of figures. 


Now position the cursor on the decimal point in the first 
number of the second column and align the numbers to the 
decimal point in exactly the same manner as just described 
for the first column. 

N.B : The cursor MUST always be positioned somewhere in the 

number to be aligned, otherwise you will get the error 
message: 

Adjustment impossible <Cont. on SPACE bar> 

This message also occurs if the attempted alignment 
would cause adjacent columns to collide or overlap. 

If you attempt to align a column to an undefined tab 
character, you will get the error message: 

Illegal Tab Chr <Cont. on SPACE bar> 

If you are following on from Lessons 3 and 4, the file, 
/MYTEXT/TABLE, will be in Document 3 of the computer's 
memory. Position the cursor in Document 3 by pressing 
Closed Apple 9 and adjusting the command line to read: 

Display :: Window [A] : Document [3] 

Press RETURN. If not, load this file into Document 3, as 
described in Lesson 3.3. 

Notice 'COL O' contains numbers which are not yet 
aligned to the decimal point. To align the numbers in 'COL 
O' to the decimal point, you must firstly set a decimal tab 
at Column 4. To do this, press Open Apple TAB and adjust 
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the command line to read: 


[Set] 

Tabs 





Press 

RETURN 

and adjust 

the next 

command 

line to read: 

Set[l 

] Tab 

at Col[4 

] Step[8 

] Align 

Chr [j_. ] 

Press 

RETURN. 






The Stemwriter program will now set 1 tab at column 4. 
To align the numbers in 'COL O' to this decimal tab, 
position the cursor on the decimal point in the first number 
to be aligned, press Closed Apple 5 and adjust the command 
line to read: 

Align Text by [Column] 

Press RETURN and adjust the next command line to read: 

Align Chr to [Near] Tab 

Press RETURN. The number in which the cursor is positioned 
will now be aligned to the nearest tab (Figure 5.3), and the 
command line will read: 

Up, Down Arrow Repeats <esc> Exits 


. .Hk_j..._:_:_:. 

Up, Down Arrow Repeats <esc> Exits 

A SAMPLE TABLE 


COL 0 

00L2 

COL 3 

COL 1 

COL 4 

COL 5 

COL 6 

12.34 

12 

13 

11 

14 

15 

16 

442.1 

22 

23 

21 

24 

25 

26 

1.23 

32 

33 

31 

34 

35 

36 

4.45 

42 

43 

41 

44 

45 

46 

445.2 

48 

53 

51 

54 

55 

56 

2.221 

52 

63 

61 

64 

65 

66 

3.185 

62 

73 

71 

74 

75 

76 

313.21 

72 

83 

81 

84 

85 

86 

3.001 

82 

93 

91 

94 

95 

96 

221.4 

92 

03 

01 

04 

05 

06 


Figure 5.3 Half the figures in column 0 have been aligned 
to the decimal tab set at column 4. 
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Use the up/down arrows keys to align the entire column of 
figures to the decimal point without disturbing adjacent 
columns in the Table. 
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6.0 LESSON 6 - SPECIAL KEYS AND OPERATIONS 


This lesson describes how to use some of the special 
keys and operations available in the Stemwriter program. 

6.1 On-Screen Super and Subscripting 


The Stemwriter program allows up to 4 nested levels of 
superscripts and 4 nested levels of subscripts per line of 
text which are automatically balanced at the end of each 
line. On-screen super-scripting is achieved by pressing the 
Open Apple key in conjunction with the up arrow key. 
Likewise on-screen subscripting is achieved by pressing the 
Open Apple key in conjunction with the down arrow key. Try 
the following examples: 


2 


n 


and C 


max 


The above examples are produced in the following way: 
Type the number 2. Then press the Open Apple key with the 
up arrow key once. The cursor will now be positioned one 
half line above the line on which the 2 is sitting, i.e. 2 . 
Now type a lower case n. To return the cursor to the same 
line as the 2 is on, press Open Apple with the down arrow 
key once. The cursor will now be positioned as follows: 



Now type a space, followed by the word, 'and', followed by 
another space. Type C. The cursor will be positioned as 
follows: 

2 n and C« 


Press Open Apple with the down arrow key once to move the 
cursor to the subscript position, as follows: 

2 and Cg 

Now type max. The cursor will still be in the subscript 
position: 


2 n and C _ 
maxi 

To return the cursor to the same line as C, press Open Apple 
with the up arrow key once. You should now have the 
following line in your document: 
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2 n and C 


max 


If you have no need to create mathematical equations 
on-screen, move on to Lesson 6.2. Otherwise, proceed with 
the remainder of Lesson 6.1. 


Now try entering a much more complex line of text 
containing nested levels of super and subscripts. Don't 
panic! It is not as hard as it looks. Remember, each time 
you want a new level of super or subscript, you select it by 
pressing the Open Apple key with either the up or down arrow 
keys respectively. If you forget to return the cursor to 
the text line before going on to the next line of your 
document, your document will not be one half line out of 
registration, as the Stemwriter program automatically 
balances super and subscripts at the end of each line. Try 
typing the following equation: 

c} = -k}.ci + e. _b - C + fl(t) ...(1) 

1 14 4 l p •_ 1 

mm 


If you don't know how to start, carry out the following 
stepwise instructions for producing equation (1) in your 
document. 

Type a C. To obtain the dot above the C, you must 
produce it in such a way that it maintains its position just 
above the C, irrespective of the line spacing used for 
printing out the document. This is achieved by pressing 
Open Apple with the up arrow key twice. The cursor is now 
positioned as follows with respect to the C. 

c 

To move the cursor to a position directly above the C, press 
Open Apple with the ESCAPE key once. The cursor will be 
positioned as follows: 

■ 

C 


Now type a period to obtain: 

*■ j* 

c 

To put in the superscript, 1, in the correct position, you 
must move the cursor down one half line by pressing Open 
Apple with the down arrow key once. Now type 1. The cursor 
will be positioned as follows: 
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To put the subscript, 1, in the correct position directly 
below the superscript, 1, you must move the cursor down two 
half lines and one position to the left. This is achieved 
by pressing Open Apple with the down arrow key twice 
followed by Open Apple with the ESCAPE key once. Type 1. 
The cursor will now be positioned as follows: 



Type a space, followed by the equals sign, followed by 
another space. Now type -k. To obtain the superscript 1 
associated with the k, press Open Apple with the up arrow 
key once. Now type 1. The cursor will be positioned as 
follows: 



To put in the subscript 14 associated with the k, press Open 
Apple with the down arrow key twice followed by Open Apple 
with the ESCAPE key once. The cursor will be positioned as 
follows: 



Now type 14. To return the cursor to the same line as the 
k, press Open Apple with the up arrow key once to give: 



Now type C. To put in the superscript 1 associated with 
this C, press Open Apple with the up arrow key and type 1. 
The cursor will be as follows: 


•1 _ . 1 „!■ 
1 14 


To put in the subscript 4 associated with this C, press Open 
Apple with the down arrow key twice followed by Open Apple 
with the ESCAPE key once to obtain: 
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Type a 4. To return the cursor to the same line as the C, 
press Open Apple with the up arrow key once, as follows: 


• i 

r' x 


- k i4 c l l 


Type a space, followed by a plus sign and another space. 
Type e. The cursor will be positioned as follows: 


To put in the subscript i associated with the e, press Open 
Apple with the down arrow key once. Type the i. You should 
now have: 



To put in the superscript 2 associated with -b, press Open 
Apple with the up arrow key once. Type 2. To return the 
cursor to the same line as the 'e', press Open Apple with 
the down arrow key twice to obtain: 



Type a space, followed by a minus sign and another space. 

Type C. You should now have: 

+ e i ‘ b2 - CB 


To put in the nested subscripts p . associated with the C, 
press Open Apple with the down arrowkey once. Type p. Now 
press Open Apple with the down arrow key again. Type min. 
To return the cursor to the same line as the C, press Open 
Apple with the up arrow key twice. The cursor will now be 
positioned as follows: 


C 1 = 

-*u c i * *i" b2 - s . ■ 

r nu n 



Type 

a space, followed by a 

plus 

sign followed by another 

space 

. Type an f. You should 

now 

have.: 

- 

-W * -,- b2 - C pmin * 

f» 
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To put in the superscript 1 associated with the f, press 
Open Apple with the up arrow key once. Type 1. The cursor 
will be positioned as follows: 

,2 


C 1 = -k 1 C 1 + e 

L 1 K 14 4 e i 


+ f 


!■ 


- mm 


To put in the subscript 1 associated with the f, directly 
beneath the superscript 1, press Open Apple with the down 
arrow key twice followed by Open Apple with the ESCAPE key 
once. Type 1. To return the cursor to the same line as the 
f, press Open Apple with the up arrow key once. Now type a 
left bracket, '(' followed by a ' t* and a right bracket, 

')'. The cursor will now be positioned as follows: 

cJ = -kKc* + e.~ b - C + f?"(t)> 

1 14 4 1 p . „ 1 

min 

Type several spaces followed by four dots. Type (1). 


Congratulations! You have now completed the whole of 
equation (1). If you feel as though you need more practice 
at entering complex equations, try entering equation (1) 
again. 

6.2 On-Screen Overstrike 


You can produce on-screen overstrike, e.g. the not 
equals sign, as follows: 

Type the equals sign. The cursor should be positioned as 
follows: 


To overstrike the equals sign with the slash, move the 
cursor one position to the left so that it is over the 
equals sign by pressing Open Apple with the ESCAPE key once. 
The cursor will now be positioned as follows: 

Type the slash to obtain: 

The not greater than sign, and the not less than sign, {, 
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can also be produced in a similar manner. 

6.3 User Definable Keys 

The Stemwriter program allows you to enter character 
strings with a single keystroke. When the Closed Apple key 
is pressed in conjunction with keys A to J, they serve as 
special User Definable Keys which you can set. 

Press Closed Apple D. The current date will be entered 
into your document. This key is always initialized at 
start-up time to show the current date. The other keys, A 
to J are initialized when Stemwriter is started up ('booted' 
in computerese), with text pre-set by the Utilities Program. 

6.3.1 Setting a Key 

Suppose the words 'Bloggs & Company' occur several 
times in the document you are about to prepare. You can 
associate these words with, e.g. User Key A, so that they 
can be entered with a single keystroke when and as required. 

Select the Set User Key command by pressing Open Apple 
= (equals). All the options for this command line are: 

Set User Key [A] 

[B] 

[ J] 

Use the up/down arrows, in the usual way, to adjust the 
command line to read: 

Set User Key [A] 


Press RETURN. The next command line will read: 


[AH 

1 

The Letter [A] at the beginning 

of the command line is a 

reminder of the key being set. 
follows: 

Type 'Bloggs & Company' as 

[A] [Bloggs & Company 

1 


Press RETURN. Try pressing Closed Apple A. Did it work? 
'Bloggs & Company' should have appeared in your document at 


Lesson 6 



Part 2 - Tutorial 


77 


the current cursor position. 

Each User Definable Key can hold up to 31 characters, 
some of which may be other User Definable Keys. For 
example, to enter the following passage of text with a 
single keystroke. 


This is a very quick and easy way to enter frequently used 
phrases of text 

you will have to chain several User Definable Keys together. 
To do this, press Open Apple = (equals) and adjust the 
command line to read: 


Set User Key IB] 

Press RETURN. The next 

command line will read: 

IB] [ 

] 


Now begin typing the phrase of text 

shown above, inside 

the square brackets. 

When you are 

one character from 

filling the box, as follows: 


[B] [This is a very quick 

and easy ] 



Type Closed Apple C and press RETURN. This tells the 
Stemwriter program to chain the text in User Key C to that 
in User Key B. 


To set User Key C, press Open Apple = (equals) and 
adjust the command line to read: 

Set User Key [Cl 

Press RETURN. The next command line will read: 

ten i 

Continue typing the nominated phrase above, beginning from 
the point you stopped for User Key B, as follows: 

[CHway to enter frequently used ] 

Now type Closed Apple E and press RETURN. This tells the 
Stemwriter program to chain the text in User Key E to that 
in User Key C. 
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To set User Key E, press Open Apple = (equals) and 
adjust the command line to read: 

Set User Key [E] 

Press RETURN. The next command line will read: 

IBM ] 

Continue typing the nominated phrase inside the square 
brackets, beginning at the point you stopped for User Key C, 
as follows: 

[E][phrases of text 3 

Press RETURN. The Stemwriter program will now chain the 
text in User Key E to that in User Key C which in turn will 
be chained to that in User Key B. 

In order to check that User Keys B, C and E have all 
been correctly chained together, press Closed Apple B. If 
the phrase 

This is a very quick and easy way to enter frequently used 
phrases of text 

appears correctly on your screen, congratulations! By 
chaining User Definable Keys together in this way, it is 
possible to enter up to 300 characters with a single 
keystroke. 

6.4 Wide Documents 


The Stemwriter program can handle lines up to 240 
characters wide even though the screen window is only 80 
characters wide. If you specify the width of your document 
to be greater than 80 characters, the current window moves 
in 40 column increments across the document so that you can 
see what you are doing. This is illustrated schematically 
in Figure 6.1. 


To produce an example of a wide document, e.g. a document 
which is 125 characters wide, press Closed Apple 9 and 
adjust the command line to read: 

Display : Window [A] : Document [5] 


Lesson 6 





Part 2 - Tutorial 


79 



Screen 

Window 


(e-40-3f{—80 —4 

K - 240-» 


Figure 6.1 Hie screen window moves in 40 column increments 
across your wide document. 


Press RETURN. As this is a new document, the command line 
will now read: 

Line : Para Indent [5 ] Line Indent [0 ] Line Width [72 1 


The Para Indent, Line Indent and Line Width values displayed 
in the command line are the default values of the Stemwriter 
program for a new document. Remember, you can enter a 
number inside the square brackets which contain an 
underlined number. Adjust the command line to show the new 
Para Indent, Line Indent and Line Width settings you want, 
e.g. : 

Line : Para Indent [5 ] Line Indent [JO ] Line Width [125] 


Press RETURN. Document 5 is now active but it contains no 
text as yet. If you do not want to type in the following 
paragraph of text, you can load it into Document 5 from the 
file, /MYTEXT/WIDEDOC. Put your user diskette, /MYTEXT, 
into the boot drive of your Apple //e or //c and load the 
file, /MYTEXT/WIDEDOC, into Document 5 of your computer's 
memory. Otherwise, begin typing the following text example: 

'This portion of text is to illustrate the manner in 
which the Stemwriter program handles documents wider than 80 
characters. As soon as you type the 81st character, the 
current screen window is moved 40 columns to the right over 
the document, so that columns 41 to 120 of the document are 
now visible on the screen. Similarly, as soon as column 121 
is reached, the screen window is again moved 40 columns to 
the right so that columns 81 to 160 of the document are now 
visible on the screen. If the current document was 240 
columns wide (the maximum document width permitted by the 
Stemwriter program), the screen window would continue to 
move in 40 column increments towards the right margin of the 
document as described above.' 
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Notice that each time the Stemwriter program starts a 
new line of text, the screen window's position is adjusted 
so that you are again viewing columns 1 to 80. The 
Stemwriter program automatically moves the screen window 
across the text in 40 column increments as required by the 
specified document width, (125 columns in this case). 

Had you displayed the Tab stops, (Lesson 4), you would 
have noted that the numbers 40, 80, and so on, appeared at 
the left of the ruler as the wide line was horizontally 
scrolled. This number is telling you the current position 
of the left hand edge of the screen window. 

6.4.1 Moving The Cursor Over Wide Documents 

Position the cursor at the beginning of Document 5 
using the JUMP command. Remember, press Closed Apple 8 and 
adjust the command line to read: 

Jump to Doc. I Head! 


Press RETURN. The cursor will now be positioned at the head 
of Document 5. 

Move the cursor over the text of the first line of the 
document, character by character, towards the right margin, 
by pressing the right arrow key. Notice that when column 81 
is reached the screen window moves so that columns 41 to 120 
are now visible. Continue to press the right arrow key. 
When column 121 is reached, the screen window again moves to 
the right by 40 columns so that columns 81 to 160 are now 
visible. 

Now move the cursor back towards the left margin, 
character by character, by pressing the left arrow key. 
Notice that when column 120 is reached, the screen window 
moves 40 characters to the left so that columns 41 to 120 
are now visible. Similarly, when column 80 is reached, the 
screen window moves 40 characters to the left again so that 
columns 1 to 80 are now visible. 

Irrespective of whether you are moving the cursor over 


the text by character. 

word, 

line 

, paragraph or 

tabbing, 

the 

screen window moves 

over 

the 

text 

in the 

manner 

just 

described. 








This manner 

of 

handling 

wide 

documents makes 

it 

particularly easy 

to 

create 

and 

edit 

wide documents of 

any 
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type, including wide tables. 

6.4.2 Re-margining A Wide Document 

Suppose you don't like 125 column lines and you wish to 
convert Document 5 to 60 column lines. To do this, press 
Open Apple 9 and adjust the command line to read: 


Set Global data for {Dine] break Calculation 

Press RETURN. The command line will now read: 


Line : Para Indent [5 ] Line Indent [0 3 Line Width [125] 

Position the cursor in the square box associated with Line 
Width, type 60 and press RETURN to accept this new Line 
Width value. Press the RETURN key again to accept this 
command line. The screen will clear momentarily and 

Document 5 will be displayed with its new, slim 60 character 
lines. That is all there is to it! 

6.5 Auxiliary Characters 

In addition to the standard 96 printing characters 
engraved on the keys of the keyboard, Stemwriter is capable 
of displaying a further 86 characters which you may design 
to match any special characters which your printer may be 
capable of producing. 

As supplied, Stemwriter is pre-configured to display 
the Greek character set. For example, holding down the Open 
Apple key whilst pressing the key 'b', will display the 
Greek letter 'beta'. Refer to the Reference and Utilities 
section for further information, on how to design your own 
Auxiliary Characters, and co-ordinate the screen display 
with your printer output. 

6.6 Clearing Documents 

By this stage, you probably have several documents in 
memory that you no longer need. When you clear these 
documents, the space they occupied will be made available 
for other uses. Press Open Apple DELETE and adjust the 
command line to show the document you want to clear, as 
follows: 
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Clear Document [1] 

Press RETURN. Document 1 will now be cleared. As the 
cursor is currently in Document 5, nothing more seems to 
happen. If, however, you cleared Document 5, i.e., the 

document the cursor is currently in, the Stemwriter program 
would now ask you what you want to do next, in the following 
command line: 

Display :: Window [A] : Document [5] 

You must now nominate the document you wish to return to. 
If it is a new document, you will be asked for the line 
width, line indent and paragraph indent information in the 
usual way. 

6.7 Repainting The Screen 

Sometimes, it may be desirable to repaint the screen 
display. This is effected by pressing Closed Apple = 
(equals). When you are in the body of the document, the 
cursor will be positioned in the center of the screen after 
repainting. 
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7.0 LESSON 7 - SPECIAL TEXT FIELDS 

Preparation ; Position the cursor in Document 1 by 
pressing Closed Apple 9 and adjusting the command line to 
read: 


Display Window [A] ; Document [1] 

Press RETURN. If Document 1 already contains text, clear it 
in the following way: 


Press Open Apple DELETE and adjust the command line to read: 


Clear 

Document [1 ] 




Press 

RETURN. The command line will 

read: 


Line : 

Para Indent [5 

] Line Indent 

[J) ] Line 

Width [72 ] 

Adjust 

this command 

line to show 

the Para 

Indent, Line 

Indent 

and Line Width 

parameters you 

want e.g. 


Line : 

Para Indent!^ 

] Line Indent 

[0 ] Line 

Width [65 ] 


Press RETURN. 


The Stemwriter program considers the text in a document 
to be arranged in Fields, where a Field is defined as a 
group of characters with special attributes. Examples of 
Fields are Underlined and Bold words. 

Fields are most easily created at the end of a 
document. To create a Special Field containing new text in 
the body of a document, you must firstly cut the document at 
the desired point, insert the text in the Special Field and 
then rejoin the text. You may also enclose pre-existing 
text in a Special Field as described in Lesson 7.8.1. 

The SPECIAL FIELD command is selected by pressing 
Closed Apple 4. All options of this command are as follows: 

[Begin] [Underline] Field 
[End ] [Bold ] 

[Clear] [Footnote ] 

[Protect ] 

[Comment ] 

[Local ] 

[Reserved ] 
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7.1 Underlining 

For on-screen Underlining, press Closed Apple 4 and 
adjust the command line to read: 

[Begin] [Underline] Field 

Press RETURN. Now press Closed Apple 1 to create a new 
paragraph, and type the text to be underlined, e.g. 

Underlined Text 

To turn the underlining off, press Closed Apple 4 and adjust 
the command line to read: 


[End] [Underline] Field 

Press RETURN. The underlining is now turned off. 

To clear underlining from a portion of text, place the 
cursor in the Underline Field to be removed. For example, 
to remove the underlining from: 

Underlined Text 

Place the cursor anywhere in the Underlined Field you wish 
to remove, as follows: 


Undjgrlined Text 

Now press Closed Apple 4 and adjust the command line to 
read: 

[Clear] [Underline] Field 

Press RETURN. Presto! The text is no longer underlined as 
follows: 

Underlined Text. 

7.1.1 Fast Underlining 

There are two methods for producing on-screen 
underline. The second and easiest method is as follows: 

Position the cursor at the head of a new line by pressing 
the RETURN key once. Press Open Apple 5 to turn the 
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underlining on. Now type the text to be underlined, e.g. 
This is Underlining 

To turn the underlining off, press Open Apple 5 again. Thus 
underlining can be readily turned on and off by pressing 
Open Apple 5 once to turn underlining on and Open Apple 5 a 
second time to turn underlining off. Pressing Open Apple 5 
changes the Underlining state. If underlining was on. Open 
Apple 5 turns it off, and vice-versa. 

7.1.2 Underlining Spaces 

The Stemwriter program does not automatically underline 
spaces because at least half the printers on the market do 
not automatically underline spaces. To force the 

underlining of spaces, you must type the Underline character 
itself (SHIFT-HYPHEN, at the top of the keyboard) in the 
space position. On your screen, the underlining of spaces 
will appear slightly higher than the underlining of 
characters. Never fear, however! When your document is 
printed, the underlining will be a continuous line beneath 
both characters and spaces. 

7.2 On-Screen Bold Text 


The Stemwriter program shows bold characters on the 
screen as inverse video. Press the RETURN key twice to 
position the cursor two lines below the Underline examples. 
To select on-screen bold characters, press Closed Apple 4 
and adjust the command line to read: 

[Begin] [Bold] Field 


Press RETURN. Now type the text to be made bold, e.g. 
BOLD TEXT IS SHOWN AS INVERSE VIDEO 


To end the Bold Field, press Closed Apple 4 and adjust the 
command line to read: 

[End] [Bold] Field 


Press RETURN. The Bold Field is now finished and the bold 
text is visible on the screen as inverse video. Bold text 
can be restored to normal text by removing the Bold Field 
from the text. To do this, place the cursor inside the Bold 
text Field, as follows: 
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BOLD TEXT HB SHOWN AS INVERSE VIDEO 

Press Closed Apple 4 and adjust the command line to read: 

[Clear] [Bold] Field 

Press RETURN. The previously bold text is now normal text 
on screen, as follows: 

BOLD TEXT IS SHOWN AS INVERSE VIDEO 


7.3 Footnotes 


If you want a particular piece of text to be included 
in your formatted and printed document/file as a Footnote, 
you must enter it into your document in a FOOTNOTE FIELD. 
Press Closed Apple 1 to position the cursor at the head of a 
new paragraph. To create the Footnote, press Closed Apple 4 
and adjust the command line to read: 

[Begin] [Footnote] Field 

Press RETURN. The symbol, J , will now appear on the screen 
in inverse video to mark the beginning or the Footnote text. 
Type in the Footnote text, e.g. 'This will appear as a 
footnote'. Press Closed Apple 4 and adjust the command line 
to read: 

[End] [Footnote] Field 

Press RETURN. The symbol, l , will now appear on the screen 
in inverse video to mark the end of the Footnote text, as 
follows: 

JThis will appear as a footnote l 


During document formatting (Lesson 10), Footnotes are 
positioned at the foot of the page on which the Footnote 
markers occur. For multi-column formatting, the Footnote 
text is positioned at the foot of the text column in which 
the Footnote marker occurs. Thus, you do not have to worry 
where the bottom of the page will be, Stemwriter takes care 
of it for you. 

To clear a Footnote Field, position the cursor in the 
Footnote Field, press Closed Apple 4 and adjust the command 
line to read: 
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[Clear] [Footnote] Field 

Press RETURN. The Stemwriter program removes the Footnote 
markers from the document but the Footnote text remains in 
the document. If you wish to remove this text from the 
document, you must remove it using either the RUBOUT or 
BLOCK WIPE commands. 

7.4 Comments 


You can insert non-printing Comments into your 
document. The Comments could be, for example, reminder 
notes to yourself about how to format your document. Press 
the RETURN key twice to position the cursor two lines below 
the Footnote text from the previous example. To insert 
Comments into your document, press Closed Apple 4 and adjust 
the command line to read: 

[Begin] [Comment] Field 


Press RETURN. The symbol, —>, will appear on the screen in 
inverse video to mark the beginning of the Comment text. 
Now type the Comment text, e.g. Format this document for 
multi-column printing. To end the Comment Field, press 
Closed Apple 4 and adjust the command line to read: 

[End] [Comment] Field 

Press RETURN. The symbol,<—, will now appear on the screen 
to mark the end of the Comment Field, as follows: 

->Format this document for multi-column printing*— 

The comment text will not be printed out - it is merely a 
comment for your own eyes at document preparation time. 

To clear a Comment Field, place the cursor inside the 
Comment Field of interest, press Closed Apple 4 and adjust 
the command line to read: 

[Clear] [Comment] Field 

Press RETURN. The Comment markers denoting the Comment text 
are removed but the actual Comment text is left in the 
document. To remove the comment text from the document use 
the RUBOUT or BLOCK WIPE commands. 
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7.4.1 Classified Comment Fields 

Classified Comment Fields are special-purpose Comment 
Fields which consist of two parts, viz: A Classification 

key (called a Class Key) and a keyword, organized as 
follows: 

-XCLASS KEY>keyword<- 

Stemwriter makes use of Classified Comment Fields for 
sorting and selecting records from a segmented file (Lesson 
15), and for Form Letter generation (Lesson 13). 

To create a Classified Comment Field, press Closed 
Apple 4 and adjust the command line to read: 

[Begin)[Comment] Field 

Press RETURN. The symbol, —> , will now appear on your 
screen marking the beginning of the Comment Field. The 
Classification word or Class key, as we will call it, must 
be entered immediately after opening the Comment Field. To 
do this, type a less than sign, <, followed by the Class 
Key, such as ZIPCODE, followed by the greater than sign, >. 
To this point, your screen will appear as follows: 

-»<ZIPCODE> 

You must now enter the actual Zipcode, e.g. 12345 to obtain: 

-»<ZIPCODE>12345 

All that remains to be done is to close the Classified 
Comment Field. To do this, press Closed Apple 4 and adjust 
the command line to read: 

[End] [Comment] Field 

Press RETURN. Your screen will now appear as follows: 

—><ZIPCODE>12 345<— 

If it does, congratulations! You have successfully created 
a Classified Comment Field. 

Remember! The CASE of the Class Key is very important. 
If the Class Key in the Comment Field is in uppercase 
letters, than it must appear in the Form letter template and 
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in the Sorting or Selecting operations in uppercase letters 
also, i.e. in exactly the same way. 

Classified Comment Fields are very important building 
blocks of the List Processing capabilities of the Stemwriter 
program. That is, if you want to create an Address List for 
use with Form Letter creation and Label printing, or a 
categorised Reference List, or a file of standard paragraphs 
on various topics, you will need to use Classified Comment 
Fields in all of these applications. So, before proceeding 
further with this Tutorial, make sure that you are very 
familiar with Classified Comment Fields. 

7.5 Protected Fields 


The internal layout of Protected Fields is unaffected 
by passage of the Protected text through the Formatter. In 
addition, it is not possible to alter text in a Protected 
Field without first turning off the Field markers. 

Press the RETURN key twice to position the cursor two 
lines below the Classified Comment Field text of the above 
example. To open a Protected Field, press Closed Apple 4 
and adjust the command line to read: 

[Begin) [Protect) Field 

Press RETURN. The symbol, 1 , will now appear on the screen 
in inverse video to mark the beginning of the Protected 
Field. Now type the text to be included in the Protected 
Field, e.g. 'Protected Fields are essential for Forms 
creation and fill-in'. When you have completed entering the 
Protected Field text, press Closed Apple 4 and adjust the 
command line to read: 

[End] [Protect] Field 

Press RETURN. The symbol, f , will now appear on the screen 
in inverse video to mark the end of the Protected Field as 
follows: 

1 Protected Fields are essential for Forms creation and 
fill-in I 1 

Text in a Protected Field cannot be altered by any text 
modification procedure such as Rubout; Cut/Paste; 
Replace/Verify; Block Copy, Move, Wipe; Overtype. For 
example, if you wanted to add the word 'rapid' just prior to 
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the word 'Forms' in the above Protected Field, you must 
first temporarily turn off the Protected Field markers. 
When you do this, all Special Field markers are temporarily 
disabled. So beware! To insert 'rapid', position the 
cursor on the 'F' in 'Forms' and temporarily turn off the 
Special Field markers by pressing Open Apple 4 and adjusting 
the command line to read: 

Turn Special Field Markers [off] 

Press RETURN. Press Closed Apple 0 once to CUT the text. 
Type the word, 'rapid', followed by a space. Now PASTE the 
text by pressing Closed Apple 0 again. 

When you have finished editing the text in the Protected 
Field, turn the Special Field markers back on to re-activate 
all Special Field markers. Press Open Apple 4 and adjust 
the command line to read: 

Turn Special Field Markers [on] 

Press RETURN. 

The Special Field Markers are now restored. 

The temporary disabling of Special Field markers can be a 
dangerous operation because all in-built safety features of 
the Stemwriter program are also disabled, so extreme caution 
should be used, expecially with regard to any of the 
Block/Column operations or Rubout. If you are not careful, 
you may find that you now have some Unbalanced Field 
markers. If so, you can recover from this situation as 
described in Lesson 7.8.3. 

To clear Protected Field markers permanently, place the 
cursor inside the Protected Field you want to remove the 
protection from, press Closed Apple 4 and adjust the command 
line to read: 

[Clear] [Protected] Field 

Press RETURN. 

The Protected Field markers are now permanently removed and 
the previously protected text is now normal unprotected text 
in the document which may be removed by using the RUBOUT or 
BLOCK WIPE commands. 
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When Protected Fields are being created, they use the 
same line break and paragraph indent settings as apply in 
the parent document at that time. 

Protected Fields are very useful for Forms Creation and 
Fill-in (Lesson 12) such that the text in the Protected 
Field is the standard Form which cannot be altered, and the 
part to be filled in, is the normal document. Load the 
example file, /MYTEXT/FORMFILL, from your user diskette, 
/MYTEXT, and have a look at it. This file will be used in 
Lesson 12 - Filling in Standard Forms. 

7.6 Local Fields 


When a Local Field is being created, it uses its own 
line and page parameter settings. To open a Local Field, 
press Closed Apple 4 and adjust the command line to read: 

[Begin] [Local] Field 

Press RETURN. The command line will read: 

Line: Para Indent [5 ] Line Indent [0 ] Line Width [22 ] 

Adjust this command line to show the Para Indent, Line 
Indent and Line Width settings you want for the Local Field, 
e.g. 

Line: Para Indent [5 ] Line Indent [5 ] Line Width [40 ] 

Press RETURN. Adjust the next command line to read a 
permutation of the following page parameter options: 


Page: Left[10] Headt^] FootU] Margins on Sheet [A] [Norm] Font[12] StylelA] 
/ [B][Rot.] [10] [B] 

[C] [PS] [C] 

[D] [15] [D] 


When the desired page parameter settings for the Local Field 
are displayed in the command line, e.g. 



Press RETURN. Adjust the next command line to read a 
permutation of the following print parameter options: 
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Line Space [1 ] at [63 Line/Inch Paper Feed [Cont] Print Color!A] 

[1.5] [8] [Sing] [B] 

[2 ] [Cut ] [C] 

[3 ] [D] 


When the parameters you want are displayed in the command 
line, e.g. 

Line Space [1.53 at [6] Line/Inch Paper Feed [Sing] Print Color [A] 

Press RETURN. The symbol, Zj, will now appear on the screen 
in inverse video to mark the beginning of the Local Field. 
Now type the text to be included in the Local Field e.g. 
'Local Fields allow you to have several different text 
layouts within the one document'. To end the Local Field, 
press Closed Apple 4 and adjust the command line to read: 

[End ] (Local] Field 

Press RETURN. The symbol, will now appear on the screen 

in inverse video, designating the end of the Local Field as 
follows: 

ZLocal Fields allow you to have several 
different text layouts within the 
one document. t*. 

Local Fields allow you to readily create documents 
containing several different text layouts within the one 
document such as is required for standard Forms. 


When the Local Field markers are turned on, you can 
overtype and rubout within the Local Field. However, you 
cannot cut/paste; move/copy/wipe or induce a new p^ge within 
a Local Field. If you attempt to do any of these things, 
the following error message will appear in the command line: 

Sorry - Special Text Field 

For an existing Local Field in a document, you may 
display the line and page settings used to set up this 
field, by positioning the cursor in the Local Field of 
interest, pressing Closed Apple 4 and adjusting the command 
line to read: 

[Begin] [Local 3 Field 
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Press RETURN. The Local Field command lines, described 
above, will be successively displayed on your screen with 
the values you chose when you first set up the Local Field. 
You may change any of the parameters displayed in the 
command lines, if you so wish, to RESET the Local Field. 

To clear a Local Field, place the cursor in the Local Field 
to be cleared, press Closed Apple 4 and adjust the command 
line to read: 

[Clear] [Local] Field 

Press RETURN. The Local Field markers are now permanently 
removed and the text previously contained in the Local Field 
is left 'in situ' as part of the normal document. This text 
will be re-margined in accordance with the Para Indent, Line 
Indent and Line Width parameters of the overall document 
after passage through the Formatter or if you re-margin the 
document globally (Open Apple 9). To remove the Local Field 
text from your document, use the RUBOUT or BLOCK WIPE 
commands. 

7.7 Reserved Fields 


The Reserved Field is identical to the Local Field with 
one addition. That is, information within a Reserved Field 
must appear entirely on the one page. The Formatter will 
move a Reserved Field during formatting to achieve this, if 
necessary. Typical Reserved Fields may be space left for a 
Graph, a Photograph or a Table. N.B : If you attempt to put 
a new page marker within a Reserved Field, you will be 
prevented from doing so and the error message 

Sorry - Special Text Field 

will appear in the command line. 

Press the RETURN key twice to position the cursor two 
lines below the Local Field text from the previous example. 
To open a Reserved Field, press Closed Apple 4 and adjust 
the command line to read: 

[Begin] [Reserved] Field 

Press RETURN. Adjust the command line to show the Para 
Indent, Line Indent and Line Width parameters you want, e.g. 
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Line: Para Indent [5 ] Line Indent [0 ] Line Width [50 ] 


Press RETURN. Adjust the next command line to read a 
permutation of the permitted page parameters: 

Page: Left[10] Head [3^1 Foot [3^] Margins on Sheet [A] [Norm] Font [12] Stylet A] 


[B][Rot.] 

[10] 

[B] 

[C] 

[PS] 

[C] 

[D] 

[15] 

[D] 


When the desired page parameters for the Reserved Field are 
displayed in the command line, e.g. 

Page : Left[15] Head[5] Foot[4^] Margins on Sheet[B][Norm] FonttlO] StylelA] 

Press RETURN and adjust the next command line to read a 
permutation of the following printing options: 

Line Space: [1 ] at [6] Line/Inch Paper Feed [Cont] Print Color [A] 

[1.51 [8] [Sing] [B] 

[2 ] [Cut ] [C] 

[3 ] [D] 

When the options you want are displayed in the command line, 
e.g. 

Line Space: [1] at [6] Line/Inch Paper Feed [Sing] Print Color [A] 

Press RETURN. The symbol, 1 , will now appear on the screen 
in inverse video to mark the beginning of the Reserved 
Field. You can now create the Reserved Field you want, e.g. 
10 blank lines for a photograph. To terminate a Reserved 
Field, press Closed Apple 4 and adjust the command line to 
read: 

[End] [Reserved] Field 

Press RETURN. The symbol, P , will now appear on the screen 
in inverse video, designating the end of the Reserved Field 
as shown in Figure 7.1. 


As for Local Fields, you can overtype and rubout within 
a Reserved Field, but you cannot cut/paste; move/copy/wipe 
or induce a new page within a Reserved Field. If you try to 
do any of the above, the following error message will appear 
in the command line: 
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<1 




Sorry - Special Text Field 

As described in Lesson 7.6 for Local Fields, you may 
display the line and page settings used to set up an 
existing Reserved Field to see if these settings are still 
appropriate. To do this, position the cursor in the 
Reserved Field of interest by pressing Closed Apple 4 and 
adjusting the command line to read: 

[Begin] [Reserved] Field 

Press RETURN. The Reserved Field command lines, described 
above, will be successively displayed on your screen with 
the values you chose when you first set up the Reserved 
Field. You may change any of the parameters in the command 
lines, if you so wish, to RESET the Reserved Field. 

To clear a Reserved Field, position the cursor in the 
Reserved Field to be cleared, press Closed Apple 4 and 
adjust the command line to read: 

[Clear] [Reserved] Field 

Press RETURN. The Reserved Field markers are removed but 
the 10 blank lines remain in your document. You can remove 
then using the BLOCK WIPE command. 

7.8 Comments Applicable To All Special Fields 

If you cut the text, then begin a Special Field, viz: 
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[Begin] [Underline] Field 
[Footnote ] 

[Protect ] 

[Comment ] 

[Local ] 

[Reserved ] 

all open Special Fields are automatically closed on re¬ 
joining the text or writing the document to a disk file. 

All Special Fields may be removed from your document 
using the BLOCK WIPE command. The BLOCK WIPE markers must 
be outside the Special Field of interest, i.e. bracket the 
entire Special Field, including the Special Field markers, 
before this can be done. 

7.8.1 Placing Existing Text In A Special Field 

Preparation : Press the RETURN key twice to position the 

cursor two clear lines below the existing text in your 
document. Ensure that your user diskette, /MYTEXT, is in 
the boot drive of your Apple //e or //c, and load the file, 
/MYTEXT/EX. DOC. 1, into your document beginning at the 
current cursor position, as follows: 

Press Closed Apple 7 and adjust the command line to read: 

[Load] [Whole] File [without] Encryption and [with] Backup 

Press RETURN. If a pathname prefix other than /MYTEXT is 
displayed, delete it by pressing the left arrow until you 
have: 

Path [ ] 

You must now enter the pathname of the file to be loaded 
into this command line. Press the down arrow key until the 
name of your user diskette is displayed in the first 
position of the file pathname as follows: 

Path [/MYTEXT ] 

Press the right arrow key once. A name will now appear in 
the second position of the pathname. If /EX.DOC.1 is not 
displayed, press the up/down arrow key until /EX.DOC.1 is 
displayed in the second position of the pathname as follows: 
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Path [/MYTEXT/EX.DOC.1 1 

Press RETURN. The file, /MYTEXT/EX. DOC. 1, will now be 
loaded into your document, beginning at the current cursor 
position. 

To place paragraph 1 within a Special Field, e.g. a 
Protected Field, position the cursor at the head of 
paragraph 1 and cut the text at this point (press Closed 
Apple 0 once). Now turn the Special Field Markers off by 
pressing Open Apple 4 and adjusting the command line to 
read: 

Turn Special Field Markers [off] 

Press RETURN. 

Begin the Protected Field by pressing Closed Apple 4 and 
adjusting the command line to read: 

[Begin] [Protect] Field 

Press RETURN. 

When you rejoin the text, the Protected Field is not closed 
and so it will encompass all text from the beginning of the 
Protected Field to the end of the document. To close the 
Protected Field, position the cursor at the end of paragraph 
1, cut the text and end the Protected Field by pressing 
Closed Apple 4 and adjusting the command line to read: 


[ End ] 

[Protect] Field 


Press 

RETURN. To 

turn the Special Field 

markers on again. 

press 

Open Apple 4 

and adjust the command 

line to read: 

Turn 

Special Field 

Markers [on] 



Press RETURN. When you rejoin the text with the Special 
Field markers turned on again, all open Special Fields are 
now closed. 


Repeat the above exercise by successively placing 
paragraph 1 in different Special Fields. Remember! Clear 
the existing Special Field markers first. 
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7.8.2 Nested Special Fields 

The Stemwriter program allows you to have nested 
Special Fields, with some restrictions. For example, you 
can have Underlined, Bold, Comment and Protected text within 
Local and Reserved Fields. You may not have Local or 
Reserved Fields within a Footnote Field, or vice-versa. If 
you do so, the Stemwriter program will do the best it can, 
but the results may not always be as desired. 

7.8.3 Unbalanced Field Markers 

How does one recover from unbalanced Field markers? 
For the visible Field markers, viz: Comment, Footnote, 

Local, Protected and Reserved Fields, it is easy to see 
which marker pair has been affected, and then recover by 
cutting the text and putting in the missing marker. When 
you do this, you should move the cursor forwards over the 
text from a point preceding the Field in question to the 
position where the marker is to be restored, so that the 
correct Field status is registered by the Stemwriter 
program. Otherwise, Stemwriter may insist that a Field is 
already off, when one tries to replace a missing Field Off 
Marker. 

For the invisible markers. Underline and Bold, it is 
not quite so obvious when one of the markers is missing. 
The first thing to do is to actually detect that a markers 
is absent. The unmatched marker makes its presence known 
after a scrolling or repaint operation when a passage of 
text which should not be underlined or in bold, suddenly 
appears to be underlined or bold. To rectify the situation, 
place the cursor on the text showing the spurious attribute 
(underline or bold) and select the Clear Underline Field or 
Clear Bold Field (as the case may be) operation (press 
Closed Apple 4). The Clear Field operation will remove any 
unmatched marker of the specified Field type in the region 
adjacent to the cursor. Thus the marker anomaly will be 
removed, and valid markers will remain untouched. 

Any unmatched marker created by a careless operation, 
e.g. Wiping a block of text when the Field Markers are 
turned off, may cause serious problems when the text is 
formatted. 
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8.0 LESSON 8-FILE MANAGEMENT 

In this Stemwriter manual, we refer to both DOCUMENTS 
and FILES which we have used consistently as follows: 

A Document is a collection of alphanumeric characters 
which may occupy all or part of the computer's memory. The 
Stemwriter program allows up to 8 independent documents of 
arbitrary size to reside simultaneously in the computer's 
memory. Each document is identified and kept track of by 
the Stemwriter program by way of its unique number - from 1 
to 8. Any of the 8 documents may be cleared from the 
computer's memory at any given time, independently of any 
other document. 

When you store the contents of a document onto a disk, 
you must give the 1 information a name. The stored 
information is then referred to as a named FILE. 

To summarize: When information is in the computer's 
memory, it is known as a numbered Stemwriter Document. When 
the same information is written onto a diskette for storage, 
it is known as a named Stemwriter File. This is how 
Documents and Files are referred to consistently throughout 
this manual. 

All Files have names. To access the information stored 
in a particular Stemwriter file, you must refer to the file 
by the name previously assigned to it. 

Stemwriter Files are stored on disks. A disk may be 
removable, such as the floppy disk on which the Stemwriter 
program is stored or non-removable, such as the Apple 5MB 
Profile Disk. The information contained in a disk file 
(irrespective of the type of disk) is permanent and is not 
lost when the power is turned off, nor when you remove the 
diskette from the disk drive of your Apple //e or //c. To 
change the information in a file stored on a disk, load the 
file contents into the computer's memory where it becomes a 
document, modify the document, and then save it back onto 
the disk as a file. 

When the information in a Stemwriter file is read into 
memory, it becomes a Stemwriter Document. Documents have no 
permanence, so when the power goes off, for any reason, the 
information in a document is lost. For this reason, it is 
good practice to periodically save documents onto disks as 
files. This is known as backing up your document. 
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8.1 Whole Files And Segmented Files 

The Stemwriter program recognizes two file types for 
the storage of text, viz: WHOLE and SEGMENTED files. Whole 
files are where the information is stored and retrieved to 
and from disk as one contiguous strand. A Segmented file is 
saved on a disk as individual pieces of information which 
can be retrieved from disk individually in any order from 
within the one file. For example, segments may be pages or 
paragraphs of a document which can be printed or retrieved 
individually. Thus, segmented files are very useful for 
rapidly creating individualized boilerplated documents, e.g. 
Tenders, Legal Documents, Address Lists, Reference Lists, 
Specifications, etc. 

To save the contents of a Stemwriter Document as a 
Segmented file, each segment in the document must be 
separated from the next, by either the New Paragraph or the 
New Page commands. Alternatively, the current document 
contents may be appended as additional segments to an 
existing Segmented file. 

A file segment may be as little as one character in 
size or as much as the maximum permissable size of a 

document (51K in a 128K Apple //e or //c). A Segmented file 
may contain up to 65,535 individual segments. 

8.2 Directories, Subdirectories And Pathnames 

Directories and subdirectories act as a look-up index 
to Stemwriter files and other subdirectories. Each 

directory file points to some files on your disk, any of 
which may be a subdirectory that points to more files, and 
so on. A proper understanding and use of directories and 
subdirectories enables you to store your files as a 

hierarchial tree whose structure reflects the relationship 
between the pieces of information being stored. 

A pathname specifies the 'path' that the Stemwriter 
program must follow to find a given Stemwriter file. The 
first name the Stemwriter program reads in the pathname is 
the volume (diskette or hard disk) directory. The 

Stemwriter program then looks in a subdirectory for the 
location of the next subdirectory and so on, until it finds 
the last-named file. Each component of a pathname is called 
a LOCAL NAME and is composed of up to 15 letters, numbers 
and periods. Spaces are not permitted in Local Names and 
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they must begin with a letter. Stemwriter automatically 
converts all lower case letters to uppercase in a local 
name. 


For example, a diskette whose volume name is STEMDOCS 
may contain, among other files and subdirectories at its top 
level, the subdirectory DECEMBER. Among the files in the 
subdirectory may be the file REPORT. The file, REPORT, may 
be found by the Stemwriter program using the pathname 
/STEMDOCS/DECEMBER/REPORT. Notice the whole pathname is 
preceded by a SLASH, and the component names within the 
pathname are separated by slashes. This is analagous to 
having FILING CABINET NUMBER, DRAWER NUMBER and FOLDER 
NUMBER to locate the information inside the folder. 

It would be inconvenient to have to specify a complete 
pathname whenever you wish to locate a file, so the 
Stemwriter program has a very simple and direct method of 
building up file pathnames which does not require you to 
actually remember the directory, subdirectory or file names 
but merely to be able to recognize them, i.e. Stemwriter 
allows you to build up pathnames by 'seeing and pointing' at 
names rather than 'remembering and typing' names. 

The foregoing descriptions will now be illustrated in 
the following Tutorial on the File Management Command Lines. 

Before proceeding, position the cursor in Document 1 as 
follows: 


Press Closed Apple 9 and adjust the command line to read: 


Display :: Window [A] : Document [1] 





Press RETURN. Clear all existing 

documents 

from 

the 

computer's memory. Press Open Apple DELETE 

command line to read: 

and 

adjust 

the 

Clear Document [5] 

Press RETURN. Press Open Apple DELETE 

command line to read: 

again 

and 

adjust 

the 

Clear Document [4] 






Press RETURN. Clear the remaining documents in the 
computer's memory in an analagous manner. As the cursor is 
positioned in Document 1, when it is cleared the command 
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line will read: 

Display :: Window [A] : Document [1] 

Press RETURN. Select the Para Indent, Line Indent and Line 
Width parameters you want for Document 1 in the next command 
line. For example: 

Line : Para Indent [5^ ] Line Indent [0 ] Line Width [J72 } 

Press RETURN. If you type in new text at this point to 
create a new document, the paragraph indent, line indent and 
line width values of 5, 0 and 72 respectively, will apply. 
However, if you load an existing file into the computer's 
memory, the paragraph indent, line indent and line width 
information saved with the file will take precedence. In 
the file /MYTEXT/EX.DOC.1, the paragraph indent, line indent 
and line width parameters are 10, 0 and 60 respectively. To 
change these parameters, you must firstly load the file into 
the computer's memory as Document 1, as follows: 


Press Closed Apple 7 and adjust the command line to read: 


[Load] [whole] File [without] 

Encryption and [with 

] Backup 


Press RETURN. Display 

the 

pathname of 

the file 

to be 

loaded, using the arrow 
following command line: 

keys 

in the usual 

way, as 

in the 

Path[/MYTEXT/EX.DOC.1 



] 



Press RETURN. To globally re-margin Document 1 so that it 
now has a Para Indent of 5 characters, a Line Indent of 0 
characters and a Line Width of 72 characters, press Open 


Apple 9 and adjust 

the command line to read: 



Set Global data for 

[line] break calculation 



Press RETURN. The 

command line will read: 



Line : Para Indent 

[10 ] Line Indent [0 ] Line Width 

[60 ] 

as it reflects the saved and restored values, 
values in the command line, as follows: 

Enter 

the new 

Line : Para Indent 

[5 ] Line Indent [£ ] Line 

Width 

i-j 

to 


Press RETURN. Document 1 is now automatically re-margined 
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so it has a line width of 72 and a paragraph indent of 5 
characters. 

8.3 Loading Whole Files 


Press Closed Apple 7. All options of the LOAD/SAVE 
file command are shown below with the default command line 
at the top: 

[Load] [Whole] File [without] Encryption and [without] Backup 
[Save] [Segt.] [with ] [with ] 

For loading files, the Stemwriter program ignores the 
[with]/[without] Backup portion of the command line. Backup 
only applies to Saving files. 

To load the file /MYTEXT/EX. DOC. 1 from the disk into 
the computer's memory, press Closed Apple 7 and adjust the 
command line to read: 

[Load] [Whole] File [without] Encryption and [without] Backup 
[with ] [with ] 


Press RETURN and then press the left arrow key (a 
destructive backspace) until the command line is clear, as 
follows: 

Path [ ] 


You must now specify the pathname for locating the file 
EX.DOC.1. The easiest and simplest method for producing the 
file pathname is as follows: 

Press the down arrow key once. The Stemwriter program 
automatically writes the name of the volume (diskette) 
contained in the boot disk drive into the first position of 
the pathname. For example, as the diskette in the boot 
drive is your user diskette, /MYTEXT, the pathname thus far 
will be: 

Path [/MYTEXT ] 

If you have additional floppy disk drives or a Profile 
hard disk, the Stemwriter program will automatically write 
the name of the diskette contained in an additional disk 
drive or of the Profile, with each successive press of the 
up/down arrow keys. For example, if the file you want is 
stored on a Profile hard disk, adjust the Pathname in the 
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command line to read as follows: 

Path [/PROFILE ] 

Similarly, if the file you want to load into the computer's 
memory is stored on a diskette (e.g. a diskette by the 
volume name, /REPORTS) contained .in an additional disk 
drive, you would adjust the Pathname in the command line to 
read: 

Path [/REPORTS ] 

In this way, you only need to recognize the name of the 
volume on which the file is stored, you don't have to 
remember it. 

Remember, you are looking for the file EX.DOC.1 stored 
on the volume (diskette) , /MYTEXT. Adjust the command line 
to read: 

Path [/MYTEXT ] 

To obtain the next level in the pathname, press the right 
arrow key once. The Stemwriter program will automatically 
write the name of the first file or subdirectory it reads 
into the next position in the pathname. If there is only 
one file on /MYTEXT, the command line will read as follows: 

Path [/MYTEXT/EX. DOC.1 ] 

If there are any other files or subdirectories on the 
diskette (volume) /MYTEXT, they may be shown in the pathname 
by pressing the up/down arrow keys. For example, if there 
were only 6 files stored on /MYTEXT, the pathname could be 
adjusted successively to read: 


Path [/MYTEXT/EX.DOC.2 ] 
Path [/MYTEXT/EX.DOC.3 ] 
Path [/MYTEXT/EX.DOC.4 ] 
Path [/MYTEXT/EX.DOC.5 ] 
Path [/MYTEXT/EX.DOC.6 ) 


Each of the files EX.DOC.1 to EX.DOC.6 is a user file. 
If you press the right arrow key again, the message 

Sterile Pathway <Cont. on SPACE bar> 

will appear in the command line. If this message does 
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appear, the last name which appeared in the pathname was 
that of a user file rather than a subdirectory. 

On pressing the space bar, the pathname is 
automatically restored to the last complete pathname as 
follows: 

Path [/MYTEXT/EX.DOC.1 ] 

When you are satisfied that the pathname displayed in the 
command line is the one you want, press RETURN to accept it. 
The user file, EX.DOC.1, is now read from the diskette, 
/MYTEXT, into the computer's memory as Document 1, with the 
cursor positioned at the head of the document. 

Of course, if you like, you can type all or part of the 
pathname instead of using the arrow keys. For example, you 
could specify the pathname for the file, /MYTEXT/EX.DOC.1, 
in one of the following ways: 

(i) Type the whole pathname using the volume and file 
names. 

(ii) Type the volume name and then press the right arrow 
key once. 

To load a file with a longer pathname than in the 

previous example, e.g. 

[/STEMDOCS/DECEMBER/JONES/REPORT ] 

you would use precisely the same strategy as that described 
above using the arrow keys to build up the pathname. 

8.4 Encryption 

If you want to load a file that was previously saved to 
disk as an encrypted file, the Stemwriter program will ask 

you for the password before it will decipher and load the 

encrypted file into the computer's memory. This system for 
encrypting sensitive and confidential files gives you a 

great deal of protection because without the PASSWORD, your 
files cannot be deciphered, irrespective of whether or not 
they have been loaded into the computer's memory using 
another program, because without the correct password, they 
will appear as gibberish. 

Ensure that your user diskette, /MYTEXT, is in the boot 
drive of your Apple //e or //c because there is an example 
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of an encrypted file on it. It has been written onto the 
diskette using the password, ENCRYPT. Notice the password 
is entirely in capital letters. Try loading this encrypted 
file into the computer's memory as Document 4. The pathname 
for the encrypted file is /MYTEXT/SCRAMBLE. 

Press Closed Apple 9 and adjust the command line to 

read: 


Display :: Window lA] : Document [4) 

Press RETURN. The command line will read: 


Line : Para Indent 15 ] Line Indent [0 ] Line Width 172 ] 

Press RETURN as the Para Indent, Line Indent and Line Width 
information saved with the file /MYTEXT/SCRAMBLE will take 
precedence. Press Closed Apple 7 and adjust the command 
line to read: 

{Load] [Whole] File [with ] Encryption and [with 3 Backup 

When loading a file, the Stemwriter program ALWAYS checks to 
see if it was saved Encrypted. If so, the Stemwriter 
program asks you for the password. Thus irrespective of 
whether [with] or [without] Encryption is specified in the 
command line for loading a file into the computer's memory, 
the Stemwriter program always checks to see if the file was 
saved to disk in an encrypted state. 

Press RETURN. The Stemwriter program now asks you for the 
file pathname in the following command line: 

Path [ ] 

Using the arrow keys in the usual way, display the file 
pathname in this command line as follows: 

Path [/MYTEXT/SCRAMBLE ] 

Press RETURN. As this file is an encrypted file, the 
Stemwriter program now asks you for the password in the next 
command line: 

Password [ ] 

Type in the password, ENCRYPT and press RETURN. Remember, 
case matters for passwords! If you typed the password as 
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lowercase letters or a mixture of upper and lower case 
letters or you typed the wrong password altogether, the 
message 

Sorry - Wrong Password <Cont. on SPACE bar> 

will appear in the command line. On pressing the space bar, 
you are no longer in the LOAD/SAVE command. 

When you have entered the correct password, ENCRYPT, 
the Stemwriter program uses this password to decipher the 
file, /MYTEXT/SCRAMBLE, which is then loaded into the 
computer's memory as Document 4. 

N.B : If you forget your password, the information is lost 
permanently because even if you manage to load the encrypted 
file into the computer's memory using another program, the 
encrypted file will appear as gibberish, i.e. it will be in 
the encrypted state. Thus, whatever you do, DO NOT forget 
your password. If you think you might forget it, write it 
down and keep it in a safe and secure place. 

8.4.1 Tips On Selecting Passwords 

Do not choose a password that someone can easily guess 
such as your name, your wife or husband's name, the name of 
your business, the street you live in, or any other word 
that people might readily associate with you. 

The password may be up to 8 characters long. It is 
preferable if you use all 8 characters with no duplicates 
for the password, as this will make it harder for somebody 
to guess it. Any printing character is acceptable for 
inclusion in the password including spaces. The case of the 
characters in your password is important. For example, if 
you originally selected your password as lowercase 
characters, you must enter it as lowercase characters before 
it will be accepted by the Stemwriter program to decrypt and 
load your file. If you type your password and hold down the 
CONTROL key at the same time, the password does not appear 
on the screen. Thus, there is no possibility of anybody 
accidentally reading your password as you type it. However, 
you must remember that if you save an encrypted file using 
the CONTROL key associated with your password, you must use 
the CONTROL key with your password to load the encrypted 
file back into the computer's memory, i.e. you must use 
exactly the same key sequences for the Password for loading 
an encrypted file as you did for saving the file in the 
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encrypted state. 

8.5 Loading Segmented Files 

Load the segmented file, /MYTEXT/ADDRESS, from your 
user diskette, /MYTEXT, into Document 3 of your computer's 
memory by pressing Closed Apple 9 and adjusting the command 
line to read: 

Display :: Window [A] : Document [33 

Press RETURN. The command line will read: 

Line : Para Indent [5 3 Line Indent [0 3 Line Width [72 3 

Press RETURN. Remember, existing files are loaded into the 
computer's memory with the Para Indent, Line Indent and Line 
Width information saved with the file, except when loading 
information from a file into the body of a document. 

Load the example segmented file, /MYTEXT/ADDRESS, 
(which consists of 26 segments) into Document 3 as follows: 

Press Closed Apple 7 and adjust the command line to read: 

[Load] [Segt.3 File [without] Encryption and [with 3 Backup 

Press RETURN. The command line will read: 

Load Segments [ ] 

You must now nominate which segments from the segmented 
file, /MYTEXT/ADDRESS, are to be loaded into the computer's 
memory as Document 3. 

The scheme for loading segments from a Stemwriter 
segmented file is as follows: 

Load Segments [low number..high number:Repeat[Step3 3 

An example of this scheme is: 

Load Segments [1..5:2[2] ] 

Using this scheme, the segments will be loaded in the order 
1,3,5,1,3,5. i.e. the Stemwriter program looks at segments 
1 to 5 (low number to high number), reads every second 
segment beginning with the first segment (step 2) and this 
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process is repeated twice (repeat 2). 

It is not necessary to specify a number for every part 
of the Load Segments scheme. For example, another valid 
scheme for loading segments from a segmented file is: 

Load Segments [1 ] 

This is a shorthand form for: 

Load Segments [l..l:l[l] ] 

The Stemwriter program automatically assigns the default 
value of 1 to any part of the Load Segments scheme which is 
not specified. 

Load Segments [1 ] 

tells the Stemwriter program to load segment 1 from the 
specified segmented file into the computer's memory as 
Document 3. 

Another valid Load Segments scheme is as follows: 

Load Segments [1..25C2] ] 

This is a shorthand form for: 

Load Segments [1..25:1(2] ] 

The Stemwriter program will load every odd numbered segment 
between segments 1 and 25 inclusively, into the computer's 
memory as Document 3. 

In every Load Segments scheme, 

Load Segments [low number..high number:Repeat[Step] ] 

-a component- 

the Stemwriter program allows you to specify up to 12 
different components, each separated by a comma, inside the 
square brackets associated with the Load segments command 
line. The simplest example of this is as follows: 

Load Segments [1,2,4,5,6,7,8,15,16,17,19,24,25] 

The above Load Segments scheme comprises 12 components each 
separated by a comma. The commas separate different 
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components of the Load Segments scheme. Each component of a 
Load Segments scheme may contain any or all of the possible 
parameters described above. An example of a more complex 
scheme for nominating the segments to be loaded from a 
segmented file is as follows: 

Load Segirents [1..13:2[2],14,3,19..22,25,4..10:4[2],11,19..21[2] ] 

This Load Segments scheme comprises 8 components, each of 
which is separated by a comma. The segments will be loaded 
into Document 3 in the following order: 1,3,5,7,9,11,13,1, 
3,5,7,9,11,13,14,3,19,20,21,22,25,4,6,8,10,4,6,8,10,4,6,8, 
10,4,6,8,10,11,19,21. 


If you attempt to put more than 12 components into a 
Load Segments scheme, the error message 

Entry error at Underline <Cont. on SPACE bar> 

will appear in the command line. When you press the space 
bar, the first position in the Load Segments command line 
where the error occurred, is underlined. For example, if 
you try to nominate more than 12 components in the Load 
Segments command line, the 13th component is underlined as 
follows: 


Load Segments [1,2,3,4,5,6,7,8,9,10,11,12,JL,14,15 ] 

This indicates there is an error in the Load Segments scheme 
from the 13th component onwards. 


In fact, any Load Segments scheme error, such as the 
following, will produce underlining indicating at least one 
error in the command line. 


Load Segments [1..4, 4..^_6] 
Load Segments [1..4^5..7 ] 

Load Segments [1.. 4:2j_2 ] 

Load Segments [ 1. . 4: 2 [ 2H 


too many dots between 4 and 6. 
4 and 5 separated by a dot 
instead of a comma 
2 and 2 separated by a colon 
instead of a comma 
right round bracket instea,d of 
right square bracket. 


When you have the Load Segments scheme you want displayed in 
the command line, press RETURN. The command line will now 
read: 

Path [ ] 
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Using the arrow keys in the usual way, display the pathname 
of the segmented file of interest in the command line as 
follows: 

Path [/MYTEXT/ADDRESS ] 

Press RETURN. The Stemwriter program now loads the 
nominated segments from the segmented file, /MYTEXT/ADDRESS, 
into Document 3. 

8.6 Saving Stemwriter Files 

You can save a document in the computer's memory onto 
disk as a Whole or Segmented file; with or without 
Encryption; with or without Backup. 

8.6.1 Saving Whole Files 

Ensure that your user diskette, /MYTEXT is in the boot 
drive of your Apple //e or //c, and save the contents of 
Document 4 onto your user diskette as a whole encrypted 
file. To do this, position the cursor in Document 4 by 
pressing Closed Apple 9 and adjusting the command line to 
read: 

Display :: Window [A] : Document [4) 

Press RETURN. Now, press Closed Apple 7 and adjust the 
command line to read: 

Save [Whole] File [with ] Encryption and [with ] Backup 

Press RETURN. The Stemwriter program now asks you for the 
pathname for saving the file in the following command line: 

Path [ 1 

Use the arrow keys to display the name of your user diskette 
in the first position of the file pathname as follows: 

Type a slash. The command line will now read: 

Path [/MYTEXT/ ) 
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Now type the name you wish to assign to this file in the 
second position of the pathname, e.g. EX.DOC.4. The command 
line will read: 

Path [/MYTEXT/EX.DOC.4 3 

Press RETURN. As this file is to be saved encrypted, the 
Stemwriter program now asks for your password. The command 
line should now read: 

Password [ 3 

Type in your password. Remember it may be up to 8 
characters long and the case is important. You can choose 
any password you like, but make sure you don't forget it. 
If you think you might forget it, write it down and put it 
in a secure place. If you don't want your password to 
appear on the screen, press the CONTROL key at the same time 
as you type the password. If you do this when saving your 
file, you must also do it when loading the encrypted file 
back into the computer's memory, otherwise the password will 
be considered invalid. 

After typing your password, press RETURN. The 
Stemwriter program will now save Document 4 onto your user 
diskette, /MYTEXT, as the file, /MYTEXT/EX.DOC.4, encrypted 
using the password you selected. 

8.6.2 Backing Up Files •* 

It is a good idea to always save your files with 
Backup. If you do this, you can never accidentally 
overwrite one of your files because the existing file is 
firstly renamed with the suffix .BAK appended to its name to 
become the Backup file. The new file is then created with 
the original name. If you always save your files with 
Backup, the Stemwriter program is smart enough to know that 
when there is no previously existing file of a given name, 
no Backup is required. Thus, unless you have a very good 
reason, ALWAYS save your files with Backup. 

8.6.3 Saving Segmented Files 

You can save a document as a segmented file or you can 
append a document as additional segments to an existing 
segmented file. 
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Save the contents of Document 3 onto your user 
diskette, /MYTEXT, as a segmented file. Position the cursor 
in Document 3 and Window A as follows: 

Press Closed Apple 9 and adjust the command line to read: 

Display :: Window [A] : Document [3] 

Press RETURN. 

To save Document 3 to disk as a segmented file without 
encryption, press Closed Apple 7 and adjust the command line 
to read: 

Save [segt.] File [without] Encryption and [with] Backup 

Press RETURN. The available Save Segmented File command 
options (default options in the top line) are as follows: 

[Save] [this] [para] as Segment 
[Add ] [all ] [page] 

Adjust the command line to read: 

[Save] [all] [para] as Segment 

Press RETURN. This command line tells the Stemwriter 
program to save each paragraph in Document 3 as an 
individual segment in the nominated segmented file. 

You must now nominate the file pathname for saving the 
segmented file in the next command line: 

Path [ ] 

If a name other than /MYTEXT is displayed in the first 
position of this command line, clear it by pressing the left 
arrow key and then use the up/down arrows in the usual way, 
to display /MYTEXT in the first position of the pathname as 
follows: 


Path 

[/MYTEXT 

] 

Type 

a slash. 

The command line will now read: 

Path 

[/MYTEXT/ 

HHHHHHHHHHHIIHHH 


Now type the name you have chosen for your segmented file 
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into the command line, e.g. EX.SEGTED. When the complete 
file pathname is displayed in the command line. 

Path [/MYTEXT/EX.SEGTED ] 

press RETURN. Document 3 will now be written onto the 
diskette, /MYTEXT, as the segmented file, EX.SEGTED, with 
each paragraph being saved as one individual segment. 

8.6.4 Adding To Segmented Files 

You may add new segments to an existing segmented file 
with additional segments being separated by either the new 
page or new paragraph commands. Thus, segmented files may 
be composed of a mixture of segments separated by either the 
new paragraph or the new page commands. To add new segments 
to an existing unencrypted segmented file, try appending 
Document 4 to the segmented file, /MYTEXT/EX.SEGTED. To 
position the cursor in Document 4, press Closed Apple 9 and 
adjust the command line to read: 

Display :: Window [A] : Document [4] 

Press RETURN. The cursor will now be positioned in Document 
4 which is now the active document. 

Press Closed Apple 7 and adjust the command line to read: 

Save lsegt.3 File [without] Encryption [with] Backup 
Press RETURN and adjust the command line to read: 

[Add] [all] [Para] as Segment 

Press RETURN. This command line tells the Stemwriter 
program to add all paragraphs in Document 4 to the nominated 
segmented file, as additional segments. 

You must now nominate the pathname of the file the new 
segments are to be appended to, in the next command line: 

Path [/MYTEXT ] 

If you have been following on from the previous exercise, 
the volume name /MYTEXT will already be in the first 
position of the file pathname. If some other prefix is 
shown, delete it using the left arrow key, and then use the 
up/down arrow keys in the usual way, to obtain: 
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Path [/MYTEXT 1 

Press the right arrow key once and use the up/down arrows in 
the usual way to adjust the second position in the file 
pathname to show the name of the file you want to add new 
segments to, as follows: 

Path [/MYTEXT/EX.SEGTED ] 

Press RETURN. The new segments, i.e. all paragraphs from 
Document 4, are now appended to the end of the existing 
segmented file, /MYTEXT/EX.SEGTED. The existing file, 
/MYTEXT/EX.SEGTED is not backed up as it is not overwritten 
at any stage. 

If you load a segmented file, e.g. /MYTEXT/EX. SEGTED, 
into the computer's memory as a document and change the 
order of the segments, and then save the re-ordered segments 
to disk as the segmented file, /MYTEXT/EX.SEGTED with 
Backup, the Stemwriter program will first rename the 
existing file to become /MYTEXT/EX.SEGTED.BAR. The 

Stemwriter program then creates the new version of the file, 
/MYTEXT/EX.SEGTED, containing the re-ordered segments. 

Whether saving information as a segmented file or 
adding information to an existing segmented file, [this] in 
the command line refers to either the paragraph or the page 
in which the cursor is currently positioned, e.g. 

[Add] [this] [Para] as Segment 

appends the paragraph in which the cursor is positioned as 
an additional segment at the end of the nominated segmented 
file. Similarly, 

[Add] [this] [Page] as Segment 

appends the page in which the cursor is positioned as an 
additional segment at the end of the nominated segmented 
file. 

Similarly, 

[Save] [this] [Para] as Segment 
[Page] 

tells the Stemwriter program to save the paragraph or page 
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in which the cursor is positioned as a segmented file of the 
assigned name. 
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9.0 LESSON 9-FILE UTILITIES 

The File Utilities command allows you to List or Create 
a File Directory, Rename or Delete a file and List a Volume 
Map. The File Utilities command is selected by pressing 
Open Apple 7. All possible options of this command are: 

File Operations: [Rename File ] 

[Wipe File ] 

[New Directory ] 

[List Directory] 

[Volume Map ] 

Preparation: Ensure that your diskette, /MYTEXT, is in the 

boot drive of your Apple //e or //c. 

9.1 Rename A File 


Press Open Apple 7 and adjust the command line to read: 

File Operations [Rename File] 


Press RETURN. The command line will read: 

Ren. [ ] 


Using the up/down arrow keys in the usual way, display the 
name of the volume (disk) on which the file to be renamed is 
located. For example, to rename the file, EX.DOC.4, on the 
diskette, /MYTEXT, adjust the command line to read: 

Ren. [/MYTEXT ] 


Press the right arrow key once and using the up/down arrow 
keys in the usual way, display the name of the user file to 
be renamed in the second position of the pathname as 
follows: 

Ren. [/MYTEXT/EX.DOC.4 ] 

If you try to select a non-existent subdirectory on the 
diskette, /MYTEXT, by pressing the right arrow key once too 
often, the error message 

Sterile Pathway CCont. on SPACE bar> 

will appear in the command line. When you press the space 
bar, you are returned to the last valid pathname, i.e. 
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Ren [/MYTEXT/EX.DOC.4 ] 

You can escape from the File Operations command (or any 
other command for that matter) by pressing ESCAPE. 

Press RETURN. 

As the file, EX.DOC.4, was saved as an encrypted file, the 
Stemwriter program now asks you for the password as follows: 

Password ( ] 

When, you have entered the password, press RETURN. If you 
entered the correct password, the Stemwriter program now 


asks you for the name to be assigned 
Renamed, in the following command,line: 

to the 

file being 

To [/MYTEXT 


] 


After you have typed the new 
line, e.g. 

file name 

into 

the command 

To [/MYTEXT/DEMO.4 


] 



Press RETURN. The file is now Renamed from EX.DOC. 4 to 
DEMO.4. If you press RETURN before you have nominated the 
new file name, the error message 


Pathname Syntax Error CCont. on SPACE bar> 

will appear in the command line. On pressing the space bar, 
you are no longer in the File Utilities command. 

9.2 Deleting A File 

To delete the file, /MYTEXT/EX.DOC. 2, from your user 
diskette, /MYTEXT, press Open Apple 7 and adjust the command 
line to read: 


File Operations [Wipe File] 

Press RETURN. The command line will read: 


Wipe [ 1 

Using the up/down arrow keys in the usual way, display the 
name of your user diskette, /MYTEXT, in the first position 
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of the command line as follows: 


Wipe [/MYTEXT 



1 


Press the right arrow 

key 

once. Using the up/down 

arrow 

keys, display the 

name of 

the file to be deleted 

in the 

second position of 

the 

command line as follows: 


Wipe t/MYTEXT/EX.DOC.2 


] 


Press RETURN. If 

the 

file 

you want to delete is encrypted. 

you will be asked 
next command line: 

to 

enter 

the encryption password 

in the 

Password [ 

] 





When you have entered the password, press RETURN. When the 
correct password has been entered, you are permitted to 
delete the nominated file. 


Before the file, EX.DOC.2, is removed from the 
diskette, /MYTEXT, you are asked whether you really want to 
delete the nominated file: 

Continue Operation <esc>/Y/N 

To proceed with the deletion of the file, /MYTEXT/EX.DOC.2, 
press Y. However, if you don't want to delete the nominated 
file, press N or ESCAPE. Irrespective of whether you press 
N or ESCAPE, the result is the same, viz: the file is not 
deleted, and you are no longer in the File Operations 
command. If you press Y to remove the file but the file 
pathname is incomplete or inaccurate, the error message 

Pathname Syntax Error <Cont. on SPACE bar> 

appears in the command line. When you press the space bar, 
you are no longer in the File Operations command. 

9.3 Creating A New Subdirectory 

You may create a new subdirectory on a diskette, or on 
the PROFILE hard disk from within the Stemwriter program 
using an option of the File Operations command. Press Open 
Apple 7 and adjust the command line to read: 

File Operations: {New Directory] 
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Press RETURN. The command line will read: 

New [ ] 

Display the volume (diskette) name on which you wish to 
create the new directory. For example, to create a new 
directory on your user diskette, /MYTEXT, adjust the command 
line in the usual way, to read: 


New [/MYTEXT 


] 

Type a slash. 

The command 

line should now read: 

New [/MYTEXT/ 


] 

Now type the name of the 
into the command line, as 

new subdirectory, e.g. ACCOUNTS, 
follows: 

New [/MYTEXT/ACCOUNTS 

] 


Press RETURN. A new subdirectory called ACCOUNTS is now 
created on the diskette, /MYTEXT, and you are no longer in 
the File Operations command. 

9.4 Listing A Directory 

You may list the file directory of a particular volume 
from within the Stemwriter program. The files in the 
directory may be listed according to File Type and the 
listed directory may be captured to a document in the 
computer's memory. To list the directory of your user 
diskette, /MYTEXT, press Open Apple 7 and adjust the command 
line to read: 

File Operations: [List Directory] 

Press RETURN. All of the available List Directory command 
options are as follows: 

List [All] Files [without] Capture to Doc.[8] 

[Text] [with] 

[Segt] 

This command line tells the Stemwriter program to list all 
files on a particular volume, or only the text files or only 
the segmented files. The directory may be captured to a 
document which may then be printed or saved to a disk file. 


Lesson 9 





Part 2 - Tutorial 


121 


Initially, adjust the command line to read: 

List [All] Files [without] Capture to Doc.[8] 

Press RETURN. The command line will now read: 


List [ ] 

To list the directory of your user diskette, /MYTEXT, adjust 
the command line in the usual way, to read: 

List [/MYTEXT ] 

To list all files in the directory, /MYTEXT, press RETURN. 
Your screen will now resemble Figure 9.1. 


<Cont. on SPACE bar> 




List of All 

Files in 

Directory /MYTEXT 


Name 

Type 

Created 

Modified 

Blocks 

INDEX 

Segt 

2-Jun-84 

2-Jun-84 

9 

SBGTBL0000 

Data 

2-Jun-84 

2-Jun-84 

1 

EX.DOC.1.LIB 

Text 

2-Jun-84 

2-Jun-84 

7 

EX.DOC.2 

Text 

2-Jun-84 

2-Jun-84 

6 

TABLE 

Text 

2-Uun-84 

2-Jun-84 

4 

WIDEDOC 

Text 

2-Jun-84 

2-Jun-84 

4 

WIDETABLE 

Ttext 

2-Jun-84 

2-Jun-84 

4 

SUPERWIDE 

Text 

2-Jun-84 

2-Jun-84 

5 

SCRAMBLE 

Text 

2-Jun-84 

2-Jun-84 

5 

ADDRESS 

Segt 

2-Jun-84 

2-Jun-84 

6 

SEGIBL0001 

Data 

2-Jun-84 

2-Jun-84 

1 

PORMTEXT 

Text 

2-Jun-84 

2-Jun-84 

13 

ARTICLES 

Segt 

2-Jun-84 

2-Jun-84 

14 

SEGTBL0002 

Data 

2-Jun-84 

2-Jun-84 

1 

LETTER 

Text 

2-Jun-84 

2-\Jun-84 

7 

PORMFILL 

Text 

2-Jun-84 

2-Jun-84 

4 

MAIL.LIST 

Segt 

2-Jun-84 

2-\Jun-84 

5 

SBGTBL0003 

Data 

2-Jun-84 

2-Jun-84 

1 

REFERENCES 

Segt 

2-Jun-84 

2-Jun-84 

8 

SEGTBL0004 

Data 

2-Jun-84 

2-Jun-84 

1 

FORMLETTER 

Text 

2-Jun-84 

2-\Jun-84 

3 


Figure 9.1 List of all files saved on the diskette, /MYTEXT. 


The files in the directory are named, their type is 
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specified, i.e. whether they are Text, Segmented, Data 
files, etc; the date on which the file was created and last 
modified is stated and the number of blocks the file 
occupies is also stated. 

If you list only the TEXT files in the directory, 
/MYTEXT, your screen will resemble Figure 9.2. 


<Ccnt. on SPACE bar> 


List of Text Files in Directory /MYTEXT 


Name 

Type 

Created 

Modified 

Blocks 

EX.DOC.1.LIB 

Text 

2-Jun-84 

2-vJun-84 

7 

EX.DOC.2 

Text 

2-Jun~84 

2-Jun-84 

6 

TABLE 

Text 

2-Jun-84 

2-Jun-84 

4 

WIDEDOC 

Text 

2-Jun-84 

2-Jun-84 

4 

WIDETABLE 

Text 

2-Jun-84 

2-Jun-84 

4 

SUPERWIDE 

Text 

2-Jun-84 

2-Jun-84 

5 

SCRAMBLE 

Text 

2-Uun-84 

2-Jun-84 

5 

BORMTEXT 

Text 

2-Jun-84 

2-Jun-84 

13 

LETTER 

Text 

2-Jun-84 

2-Jun-84 

7 

PORMFILL 

Text 

2-Jun-84 

2-Jun-84 

4 

FORMLETTER 

Text 

2-Jun-84 

2-Jun-84 

3 


Figure 9.2 List of all Text files on the diskette, /MYTEXT. 


All the files are of the type. Text. 

If you list only the SEGMENTED files in the directory, 
/MYTEXT, your screen will resemble Figure 9.3. 


<Cont. on SPACE bar> 


List of Segt Files in Directory /MYTEXT 


Name 

Type 

Created 

Modified 

Blocks 

INDEX 

Segt 

2-Uun-84 

2-Jun-84 

9 

ADDRESS 

Segt 

2-Jun-84 

2-Jun-84 

6 

ARTICLES 

Segt 

2-Jun-84 

2-Jun-84 

14 

MAIL.LIST 

Segt 

2-Jun-84 

2-Jun-84 

5 

REFERENCES 

Segt 

2-Jun-84 

2-Jun-84 

8 


Figure 9.3 List of the segmented files on the diskette, /MYTEXT. 
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When you press the space bar, the information in the listed 
directory disappears from the screen and is lost unless you 
specified that it be captured to a nominated document. 
Also, you are no longer in the File Operations command. If 
you captured the directory to a specified document in the 
computer's memory, it may be accessed in that document after 
you press the space bar. The captured directory may then be 
printed for later perusal or it may be saved to disk as a 
file. 

9.5 Volume Map 

The Volume Map option of the File Operations command is 
useful for finding out which volumes are on line and how 
many free blocks of storage there is on a particular volume. 
Press Open Apple 7 and adjust the command line to read: 

File Operations : [Volume Map] 

Press RETURN. Information similar to that in Figure 9.4, 
would appear on your screen if you had the Stemwriter 
program diskette in one disk drive, your user diskette, 
/MYTEXT, in another drive, and a Profile hard disk on line: 


<Cont. on SPACE bar> 



Volumes on line 


Vol. name 

Free Blocks 

Tot. Blocks 

STEtWEUTER 

34 

280 

MYTEXT 

134 

280 

PROFILE 

1318 

9728 


Figure 9.4 List of all currently active volumes. 


When you press the space bar, the volume map(s) disappear(s) 
from the screen and you are no longer in the File Operations 
command. 
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10.0 LESSON 10 - FORMATTING TEXT FOR PRINTING 

The formatting facilities available to you in the 
Stemwriter program are extremely flexible. You can 
independently select a large number of formatting 
parameters, viz: manual, automatic or no hyphenation; 

headers; footers; page numbering; line numbering; 
paragraph numbering; line spacing; paper size; print 
ribbon color; print font; normal or alternating margins; 
multi-column (up to 4 columns) printing; fill justified 
text; inter-column margins; page preview; paragraph 
indent; line width. 

The Formatting options you want are selected by 
adjusting the command line in the usual way, to show the 
desired options. If certain options are not selected, you 
are not required to specify the parameters associated with 
these options. For example, if you select Page Numbering to 
be off, you are not asked to specify where to place the page 
numbers on the page. However, the Stemwriter program does 
ask you to select the parameters associated with the 
Formatting options you have chosen. For example, you are 
asked to specify the inter-column margins only if you select 
multi-column printing. 

In this lesson, we will explore the full range of 
Formatting options available in the Stemwriter program. The 
formatting process is begun by pressing Open Apple 0. All 
options of the first formatting command line (default 
options in the top line) are as follows: 


Print Format [Doc.] [1] to 

[Doc.] 

[2] 

[with] Page Preview 

[No] Hyphenation 

[File] [2] 

[File] 

[3] 

[without] 

[Auto] 

[3] 


[4] 


[Man.] 

[4] 


[5] 



[5] 


[6] 



[6] 


[7] 



[7] 


[8]- 



[8] 


[1] 



Reading from left to 

right 

across this command 

line, you may 


format either files or documents for printing; with or 
without Page Preview; with (manual or automatic) or without 
Hyphenation. 

The unformatted document or file is always retained as 
a separate entity from the formatted document or file. This 
means that if you wish to change the formatting, you don't 
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have to firstly strip the previous formatting characters 
from the document/file. Rather, it is simply a matter of 
re-formatting the original unformatted document/file with 
new formatting parameters. 

An integral part of formatting documents and files is 
the Multiple Documents in memory feature of the Stemwriter 
program. When you format a document in the computer's 
memory, you must allocate another document to receive the 
formatted copy of the original document. When you are 
formatting from one file to another you must nominate two 
documents to be used as scratch pads for the formatting 
process. If you format a document/file with Page Preview 
on, you are able to adjust any unsuitable page breaks, such 
as Section Headings on the bottom of a page, or single words 
on a new page by themselves, as the document is being 
formatted. During Page Preview, you can easily move between 
the formatted and unformatted versions of the page of 
interest, as they occupy separate documents in the 
computer's memory. When you move the cursor back into the 
unformatted document to make a change during Page Preview, 
the cursor is positioned at the beginning of the last line 
in the current formatted page. Also, you may display the 
unformatted and formatted versions of the document 
simultaneously on your computer's screen, i.e. in Windows B 
and C (top and bottom halves of the screen respectively). 

If the formatted pages of your document/file are to 
have Headings and/or Footings, then the Heading and/or 
Footing text must be created in separate documents in the 
computer's memory prior to beginning the Formatting process. 

When you are previewing a formatted page, you are 
prevented from making any changes to the formatted document. 
Any such attempt will result in the message: 

Forbidden-Formatted Document <Cont on SPACE bar> 

The reason for this, is that even the simplest of changes 
may substantially alter the appearance of the formatted 
page. For example, when formatting proportionally spaced 
text with fill justification, altering a single character 
may change the length of a line, such that it is no longer 
filled. More extensive alterations may change the position 
of page breaks, and so on. For this reason, you are only 
permitted to alter the source text, i.e. the unformatted 
document and re-format the page containing the alteration, 
so that proper formatting is maintained. 
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10.1 Preparing To Format 

Careful preparation is the key to successful 

formatting. Before you start, do the following: 

(a) Create the Heading/Footing text you want, in 

separate documents of the computer's memory, and 
ensure that their environments are properly set, 

(Both the [Line] and [Page] options of Open Apple 
9). 

(b) Clear any unwanted documents from memory to 

maximise the memory space available to the 

Formatter. 

(c) Plan your Document usage carefully. Two 

unallocated documents are needed when formatting 
from a file, and one when formatting from a 
Document. N.B . Don't forget the Heading and 

Footing Documents. 

10.2 Formatting From Document To Document 

Preparation: Clear all existing documents from the 

computer's memory by successively pressing Open Apple DELETE 
and adjusting the command line to read: 

Clear Document [1] 

Press RETURN. 

Clear Document [2] 

Press RETURN, etc. 

Position the cursor in Document 1 by pressing Closed 
Apple 9 and adjusting the command line to read: 

Display :: Window [A] : Document [1] 

Press RETURN. The command line will read: 


Line : Para Indent [5 ] Line Indent [0 ] Line Width[72 3 

Press RETURN. 
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This exercise involves loading the file, /MYTEXT 
/FORMTEXT, into Document 1 of the computer's memory, and 
then formatting it. Remember! Whenever you format a 
document, the original document is ALWAYS unmodified by the 
Formatting process. This is because the Stemwriter program 
makes a formatted copy of the original document which it 
writes to another document in the computer's memory. Thus, 
you must always nominate the documents you are formatting 
from and to, in the command line. Ensure that your user 
diskette /MYTEXT, is in the boot drive of your Apple //e or 
//c, and load the file, /MYTEXT/FORMTEXT, into Document 1 of 
the computer's memory as follows: 


Press Closed Apple 7 and adjust the command line to read: 


[Load] [vfriole] File [without] Encryption and 

[with 3 Backup 

Press RETURN. The command line will 

now read: 

Path[ 

] 

Using the up/down arrow keys in the 

usual way, display the 

name of your user diskette, /MYTEXT, 
of the command line. 

in the first position 

Path[/MYTEXT 

] 


Press the right arrow key once and use the up/down arrow 
keys (if needed) in the usual way to display the name of the 
file to be loaded into the computer's memory as follows: 

Path[/MYTEXT/FORMTEXT ] 


Press RETURN. The file, /MYTEXT/FORMTEXT, will now be 
loaded into Document 1 of the computer's memory. 

You are now ready to begin formatting Document 1. In 
the first instance, format Document 1 to Document 2 with No 
Hyphenation, Page Numbering on. Page Preview on. No Headings 
or Footings, a line width of 70, Left Justified text with 
normal margins. Except for the Line Width parameter, these 
are all the default values presented to you in the 
Formatting command lines. 

To begin the formatting process, press Open Apple 0 and 
adjust the command line to read: 

Print Format [Doc. HI] to [Doc.][2] [with ] Page Preview [No] Hyphenation 
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Press RETURN. The command line will now read: 


Heading [off] Footing [off] Page Numbering[on] Line Nunberingtoff] 

This command line tells the Stemwriter program that there 
are no Headings or Footings to be included in the formatted 
document, Page numbering is to be on, and Line numbering is 
to be off. 

Press RETURN and adjust the next command line to read: 

Line : Para Indentt^ ] Line Indent [£ ] Line Width[20 ] 

Document 1 will be formatted with a paragraph indent of 5 
characters and a line width of 70 characters. 

Press RETURN. The next command line will read: 

Page: LeftUO] Head[3] Foot[ 3] Margins on SheettA][Norm] Font[12] Style [A] 

Document 1 will be formatted such that when it is printed, 
each page will have a left margin of 10 characters. Head and 

Foot margins of 3 single-spaced lines, page dimensions [A], 
as defined in the Stemwriter Configuration program, with 
pages being placed in the printer normally, print size of 12 
characters per inch and Font Style [A] as defined by the 
Stemwriter Configuration program. 

Press RETURN. The next command line will read: 

Line Space[1 ] at [6] Line/Inch Paper Feed [Cont] Print Color[A] 

This command line tells the Stemwriter program to format 
Document 1 with single line spacing, at 6 lines/inch, 
continuous paper feed and print color [A] as defined by the 
Stemwriter Configuration program. 

Press RETURN. The next command line will now read: 

First Page#[jL ] at Linetl ] of [Heading] and Col[l HNorm) Margins 

This command line is concerned with the page numbering. The 
first page of the formatted document will be Number 1 and 
the page numbers will be placed in the first line of the 
margin at the top of the page in column 1, and the page 
numbers will always be in the same position on every page 
(normal margins). 
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Press RETURN. The next command line will read: 

Text Justification [left] with [1] Text Columns [Norm] Margins 

The text of Document 1 will be formatted left justified 
(ragged right margin) as a single column of text with normal 
margins i.e. successive pages will have the same margins. 

Press RETURN. The Stemwriter program will now begin to 
format Document 1, one page at a time, and the command line 
will read: 

Formatting Page 1 

When the formatting of page 1 is complete, the command line 
will read: 

Previewing Page 1 

Formatted Page 1 is now ready for previewing with the cursor 
positioned at the head of page 1 in Document 2 (the 
formatted document). Move the cursor to the end of page 1 
(press Closed Apple 8 and Jump to Doc. Tail). You will 
notice that the Footnote is correctly positioned at the end 
of the page, and the Open Apple symbol at the end of the 
page designates where the page break will occur. If you 
don't like the page break chosen by the Stemwriter program, 
you may move it to a more suitable position on the page. 
Note: Any page break you choose must occur earlier on the 

page than that calculated by the Stemwriter program. Notice 
that the page break at the end of page 1 is such that one 
line of a new paragraph (para 5) occurs at the end of the 
page. Suppose you don't like this and you would prefer the 
page break to occur at the end of the previous paragraph 
(para 4). To adjust the page break, you must firstly 
position the cursor in the unformatted document, i.e. 
Document 1. So, press Closed Apple 9 and adjust the command 
line to read: 

Display :: Window [C] : Document [1] 

Press RETURN. Document 1 is now displayed in the lower half 
of the screen and the cursor is positioned at the head of 
the last line of the current formatted page, ie. the cursor 
is positioned at the head of paragraph 5 which begins 'At 

some later stage .' . Now insert the New Page marker at 

this point by pressing Closed Apple 3 once. It is as simple 
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as that! 

To continue formatting Document 1 correctly, the 
formatting process must continue from the head of the page 
you have just adjusted. To do this, press Open Apple 0. 
All permutations of this command line are: 

[Continue] formatting at [this] page 
[Cease ] [prev] 


Adjust this command line to read: 


[Continue] formatting at [prev] 

page 

Press RETURN. Document 1 

is now formatted from the 

beginning of page 1 again, 
command line will read: 

While this is happening, the 

Formatting Page 1 

When the formatting of Page 1 
will read: 

is complete, the command line 

Previewing Page 1 



Page 1 is now formatted and ready for previewing with the 
cursor positioned at the head of the formatted document 
(Document 2). Move the cursor to the end of page 1 and check 
that the page break is where you forced it to be, at the end 
of paragraph 4. Notice that the Stemwriter program has 
correctly re-calculated the position of the Footnote on the 
bottom of the page. If you are satisfied, continue 
formatting Document 1 from the end of page 1 as follows: 
Press Open Apple 0 and adjust the command line to read: 


[Continue] formatting at [this] 

page 

Press RETURN. While the second 
formatted, the command line will 

page of Document 1 is being 
read: 

Formatting Page 2 


When page 2 is formatted, the command line will read: 


Previewing Page 2 

Page 2 is now formatted and ready for previewing with the 
cursor positioned at the head of the newly formatted page 2. 
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Move the cursor to the end of page 2 and check the page 
break. You will notice that all of the text has now been 
formatted, but don't be fooled, the formatting is not yet 
complete because you still have the option to adjust 
anything unsatisfactory on page 2. To complete the 
formatting of Document 1, press Open Apple 0 and adjust the 
command line to read: 

[Continue] formatting at [this] page 

Press RETURN. The formatting of Document 1 is now completed 
as the command line tells you: 


Formatting Complete 

The cursor is now positioned at the most recent position in 
the document from which you initiated the formatting 
process. 

If for any reason you wish to terminate the formatting 
of a document before it is complete when Page Preview is on, 
press Open Apple 0 and adjust the command line to read: 

[Cease ] formatting at [this] page 
or 

[Cease ] formatting at [prev] page 

Thus, you can cease formatting at either the head or the 
foot of the previous page. 

10.3 Formatting From Document To File 

You would format a Document to a File if the document 
was so large that the computer's memory could not contain 
both the formatted and unformatted versions of the document, 
or if you wished to retain a permanent copy of the formatted 
document. This would allow you to print all or part of the 
formatted document at your leisure. You must assign a 
document for the Stemwriter program to use as a scratchpad 
while creating the formatted document. This scratchpad will 
contain each page of the formatted document for preview, 
before it is written to disk. The formatted file is saved 
as a segmented file with each page being one segment. Thus, 
pages of the formatted file can be printed in any order you 
desire, and several copies may be printed of any nominated 
page. 
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Preparation ; If you are continuing on from Lesson 10.2, you 
must either clear Document 1 and re-load /MYTEXT/FORMTEXT, 
or remove the page break (using the BLOCK WIPE command) 
forced in this document during its formatting with Page 
Preview in Lesson 10.2. Clear Document 2 in the usual way, 
as this will be used as the formatting scratchpad. 

You are now ready to begin this exercise of formatting 
Document 1 to a disk file. In this instance, format 
Document 1 to the file, /MYTEXT/FORMATS, using Document 2 as 
a scratchpad for holding the formatted text, where it can be 
previewed, before being written to disk as a segmented file. 
Format Document 1 with Page Preview on. No Hyphenation, No 
Headings or Footings, Page Numbering on. Line Numbering on, 
a Line width of 72 characters, Left justified Text with 
Normal Margins, and 1.5 line spacing. 

To begin formatting, press Open Apple 0 and adjust the 
command line to read: 

Print Format (Doc. HI] to [File][2] [with ] Page Preview [No ] Hyphenation 


This command line tells the Stemwriter program to format 
Document 1 to a file using Document 2 as a scratchpad, with 
Page Preview on and No Hyphenation. 

Press RETURN and adjust the next command line to read: 

Headingtoff] Footingtoff] Page Numbering[on] [Line] Numbering[on] 

Numbering the lines of a document is a very useful feature 
for the editing of draft documents, particularly when 
several people are involved in the editing process. 

Press RETURN and adjust the next command line to read: 

Line : Para Indent [(3 ] Line Indent [0 ] Line Width [72 ] 

Document 1 will be formatted with a paragraph indent of 5 
characters and a line width of 72 characters. 

Press RETURN. The next command line will read: 

Page: Left[10] Head[3] Footl^] Margins on Sheet[A][Norm] Font[12] StyletA] 

These page parameters are the default values and are the 
same as those used in Lesson 10.2. 
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Press RETURN and adjust the next command line to read: 

Line Space[1.5] at [6] Line/Inch Paper Feed[Cent3 Print Color [A] 

Document 1 will be formatted^with 1.5 line spacing. Press 
RETURN and adjust the next command line to read: 

First Page#[l ] at Line[2 ] of [Footing] and Col.[Ctr][Norm] Margins 

The pages will be numbered beginning with number 1. The 
page numbers will be centered in the second line of the 
Footing margin and will be in the same position on every 
page. 

Press RETURN and adjust the next command line to read: 

Text Justification [Left] with [1] Text Colurtns [Norm] Margins 

The formatted file will be Left Justified as 1 column of 
text with non-alternating margins. 

Press RETURN. The command line will now read: 


To [/MYTEXT ] 

Ensure that your user diskette, /MYTEXT, is in the boot 
drive of your Apple //e or //c. If a prefix other than 
/MYTEXT is displayed, clear it by pressing the left arrow 
key. Now, press the down arrow key until /MYTEXT is 
displayed in the first position of this command line: 


To [/MYTEXT 



3 


Type a slash, followed by the name you 
formatted file, as follows: 

wish to 

assign to 

the 

To [/MYTEXT/FORMATS 


] 


Press RETURN, 
format Document 

The Stemwriter program will now begin 
1 and the command line will read: 

to 

Formatting Page 

1 




followed by 

Previewing Page 

1 
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Page 1 of the formatted text is now ready for previewing in 
Document 2 (scratchpad) and the cursor is positioned at the 
head of this page. Notice the line numbers down the right 
hand side of the text. Move the cursor to the end of the 
page and check that the page break is where you want it to 
be, otherwise change the page break and re-format page 1 as 
described in Lesson 10.2. When the page break is suitable, 
continue formatting Document 1 from this point by pressing 
Open Apple 0 and adjusting the command line to read: 

[Continue] formatting at [this] page 

Press RETURN. The Stemwriter program firstly writes page 1 
of the formatted document to disk as the first segment of 
the segmented file, /MYTEXT/FORMATS, then it clears the 
scratchpad, and begins to format page 2. When formatting 
starts, the command line will read: 

Formatting Page 2 


followed by 

Previewing Page 2 

Page 2 is now ready for previewing, with the cursor 
positioned at the head of page 2. Move the cursor to the 
end of this page and check the page break chosen by the 
Stemwriter program. You will notice that Figure 2 is at the 
bottom of Page 2 in its entirity and that the Footnote is 
correctly positioned at the end of page 2. Continue 
formatting Document 1 from this position. Press Open Apple 
0 and adjust the command line to read: 

[Continue] formatting at [this] page 


Press RETURN. Page 2 of the formatted document will now be 
written to the file, /MYTEXT/FORMATS, as segment 2 of this 
file. Formatting of Document 1 will now continue and the 
command line will read: 

Formatting Page 3 

followed by 

Previewing Page 3 

Page 3 is now ready for previewing with the cursor 
positioned at the head of page 3. Move the cursor to the 
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end of this page. You will notice that all of the text is 
now formatted, but as you still have the opportunity to 
preview and adjust page 3, formatting of Document 1 is not 
yet completed. To complete the formatting operation, press 
Open Apple 0 and adjust the command line to read: 

[Continue] formatting at [this] page 

Press RETURN. Page 3 of the formatted document will now be 
written to the file, /MYTEXT/FORMATS, as segment 3 of this 
file, and the file will be closed. When this is done, the 
command line will read: 


Formatting Complete 

The cursor is now at the position in the unformatted 
document from which you initiated the formatting process. 

10.4 Formatting From File To Document 

To format a disk file to a document in the computer's 
memory, you must allocate a document to be used as a scratch 
pad for parts of the file to reside in temporarily, so that 
any modifications required during Page Preview can 
conveniently be made. The scratchpad always contains the 
source text for the page just formatted. 

In this example, the file, /MYTEXT/FORMTEXT, will be 
formatted to a document in the computer's memory with Page 
Preview on, and Automatic Hyphenation. The formatted 
document will have two columns of single-spaced text, with 
centered Headings, right justified Footings, and Page 
Numbering on, all of which will have alternating margins 
i.e. the left and right page margins will be swapped for 
consecutive pages, which is very useful for formatted 
documents being printed on double sided pages. Each column 
of the formatted document will contain 35 characters, with 
an inter-column gap of 3 characters, making a total of 73 
characters in one line of the formatted Document. 

Preparation: You must create the Heading and Footing text 

in separate documents prior to beginning the formatting 
process. Create the Heading in Document 3, and the Footing 
in Document 4. Position the cursor in Document 3 as 
follows. Press Closed Apple 9 and adjust the command line 
to read: 

Display :: Window [A] : Document [3] 
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Press RETURN. Document 3 should have been clear, (if not, 
then clear it by pressing Open Apple DELETE) and adjust the 
next command line to read: 

Line : Para Indent [5 ] Line Indent [0 ] Line Width {73 ] 

A line width of 73 characters is being used to match the 
total width of a formatted line in the body of the document. 
Press RETURN. The Heading text is to be placed in the 
second line of the Heading in the formatted document, so 

press RETURN to create a blank first line, and then type: 

Formatting Example 

Center this text by pressing Closed Apple 5 and then 
pressing 'C'. The Heading text will now appear as follows: 

Formatting Example 

Press ESCAPE to exit the Line Adjust command. If you wished 
to use a different size print font, font style or line 
spacing for the Heading as compared to the default settings, 
press Open Apple 9, select the [Page] break option, and 
adjust the data in the two subsequent command lines, which 
should now be quite familiar to you. This data is used to 
place the Heading within a Local Field in the formatted 
document. 

To create the Footnote text, position the cursor in 
Document 4 by pressing Closed Apple 9 and adjusting the 
command line to read: 

Display :: Window [A] : Document [4] 

Press RETURN. Clear Document 4 if necessary, and adjust the 
paragraph indent, line indent and line width to be: 

Line : Para Indent [5^ ] Line Indent [0 ] Line Width [73 ] 

Press RETURN. Now enter the Footing text in the second line 
of the footing space by pressing RETURN to create a blank 
line, and then typing: 

Stemwriter // Tutorial 

To right justify the footing text, press Closed Apple 5 and 
then press 'R'. The Footing text will now appear as 
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follows: 

Stemwriter // Tutorial 

Press ESCAPE to exit the Line Adjust command. 

The Heading and Footing documents are now ready to be 
included in the formatting process. Ensure that Documents 2 
and 8 are currently clear. You are now ready to format the 
file, /MYTEXT/FORMTEXT, using Document 8 as the temporary 
scratchpad for the source text, and Document 2 as the 
destination for the formatted text. 

To begin the formatting process, press Open Apple 0 and 
adjust the command line to read: 

Print Format [File][8] to [Doc.][2] [with ] Page Preview [Auto] Hyphenation 

Press RETURN and adjust the next command line to read: 

Heading [an] Footing [on] Page Numbering [oni [Line] Numbering [off] 

Press RETURN and adjust the next command line to read: 

Line : Para Indent [5 ] Line Indent [0 ] Line Width [315 ] 

The line width entered (35 characters) is the width of a 

single column. Accept the column width by pressing RETURN 
and adjust the next command line to read: 

Page: LeftllO] Head] 3] Foot[3j Margins on Sheet[A][Norm] Font[12] Style[A] 

When Headings and Footings are being used, the Head and Foot 
entries are the minimum size of the respective margins. If 
a Heading or a Footing is larger than the space you have 
specified for the Head and Foot Margins, Stemwriter will 
adjust the Heading or Footing space to accommodate the 
additional text. On the other hand, if the space allowed is 
larger than the Heading or Footing, Stemwriter will fill out 
the Heading or Footing with blank lines, to the size 
specified. Press RETURN and adjust the next command line to 
read: 


Line Space!1 ] at [6] Line/Inch Paper Feed [Cent] Print Color[A] 

Press RETURN and adjust the next command line to read: 

Heading from Doc.[3] with [Alt.] Margins 
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This command line tells the Stemwriter program to read the 
Heading text from Document 3 and to place the Heading at the 
top of every formatted page using alternating margins. This 
means that for double-sided printing, the Heading text will 
always be in the same position relative to the spine of the 
printed material. Press RETURN. If you had specified a 
non-existent document for the Heading text, the following 
error message will appear in the command line: 

Doc. not opened <Cont. on SPACE bar> 

Pressing the space bar will re-display the last command 
line. To create the Heading text at this stage, you must 
firstly press ESCAPE to quit the formatting process. 
However, if the Heading text is already created, adjust the 
next command line to read: 

Footing from Doc.[4] with [Alt.] Margins 

The Stemwriter program will read the Footing text from 
Document 4, and place it at the bottom of every formatted 
page, using alternating margins. If you had omitted to 
create the Footing text, you would get the same error 
message as that when you specify a non-existent Heading 
Document, as described above. Press RETURN and adjust the 
next command line to read: 

First Page#[l ] at Line[2 ] of [Heading] and Col.lRgt] [Alt.] Margins 

This command line tells the Stemwriter program to begin the 
page numbering with 1, and to right justify the page numbers 
in the second line of the Heading margin, using alternating 
margins. In this way, for double sided printing, the page 
numbers are always in the same position on the page relative 
to the spine of the printed material. Press RETURN and 
adjust the next command line to read: 

Text Justification [Left] with [2] Text Colunns [Alt.] Margins 

The formatted text will be left justified (ragged right 
margin) as two columns of text and each page will have 
alternating margins. Thus, for double-sided page printing, 
the inner and outer margins will always be the same size 
relative to the spine of the printed text. Press RETURN. 
The next command line will read: 

Inter-Column Margins : 1-2[3J 2-3[3] 3-413) 
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The inter-column margins are independently settable so that 
you can have margins of different sizes between different 
columns of text. Irrespective of whether you have 2, 3 or 4 
columns of text per page, the Stemwriter program only uses 
the inter-column information it requires, i.e. any 
additional inter-column information is ignored. Thus 
columns 1 and 2 of text will be separated by 3 blank 
columns. Press RETURN. At this stage, the Stemwriter 
program has all the information it needs on the page layout. 
Before proceeding, it checks that the formatted document 
will not exceed the width of the physical page. If it does, 
the error message 

Line too wide CCont. on SPACE bar> 

will be displayed, and the formatting procedure will be 
terminated. Assuming that this is not the case, the command 
line asking for the name of the source file should now be 
displayed. The prefix of the last used pathname will be 
displayed. If this was the volume /MYTEXT, skip to the next 
paragraph. Otherwise, press the left arrow key as many 
times as is necessary to rubout any other prefix, until the 
pathname is clear: 

From[ ] 

You must now specify the pathname of the file to be 
formatted. The Stemwriter program will format whole files, 
or alternatively, segmented files by treating them as though 
they were whole files. In this case, we are going to format 
the whole file /MYTEXT/FORMTEXT. If it is not there 
already, place your user diskette, /MYTEXT, in the boot 
drive of your Apple //e or //c and press the down arrow key 
until you see: 

From[/MYTEXT ] 

Press the right arrow key once and then using the up/down 
arrow keys, adjust the second position in the pathname to 
show the file name, /FORMTEXT, as follows: 

From[/MYTEXT/FORMTEXT ] 

Press RETURN. The Stemwriter program now begins to format 
the file, /MYTEXT/FORMTEXT, and the command line will read: 

Formatting Page 1 
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followed by 

Previewing Page 1 

Page 1 of the document is now ready for previewing and the 
cursor is positioned at the head of this formatted page in 
Document 2. The name of the document, which we had placed 
in a wide Reserved Field, occupies the full width of the 
page, with the two columns of text below it. Notice that 
the Heading text 'Formatting Example' is centered at the top 
of Page 1 and the Page Number is right-justified at the top 
of the page. Move the cursor through the text to the end of 
Page 1. You will notice that some words have been 
automatically hyphenated to even up the line widths. For 
automatic hyphenation to occur, the word must be at least 6 
characters long, and the hyphen is positioned a minimum of 
three characters from either end of the word. Notice that 
the Footnote has been positioned correctly at the bottom of 
column 2 of the text and that the Footing text has been 
correctly right justified at the bottom of the page. 
However, the page break occurs on open quotes. This is 
unsuitable. To adjust the page break to occur just prior to 
the open quotes, you must firstly move the cursor to the 
unformatted scratch document, i.e. into Document 8. Press 
Closed Apple 9 and adjust the command line to read: 

Display :: Window [C] : Document [8] 

Press RETURN. Move the cursor to near the end of paragraph 
6, resting on the open quotes of "Recognize and Point". 
There are two ways you can effect a fix. One is to simply 
press Closed Apple 3, and force a new page at this point. 
This method is satisfactory in this case for non-filled 
text, but if we had specified f ill-justif ied text, it would 
leave this line unfilled. The second method is to cut the 
text and insert an additional two spaces before re-joining 
the text. This method will allow line filling to work 
normally, if fill-justified text is specified. You must now 
continue formatting the text from the head of this page, 
i.e. re-format Page 1. To do this, press Open Apple 0 and 
adjust the command line to read: 

[Continue] formatting at [prev] page 

Press RETURN. Page 1 will be now formatted again and the 
command line will read: 
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Formatting Page 1 
followed by 
Previewing Page 1 

Page 1 is now ready for previewing again. Move the cursor 
to the end of Page 1 and check that the page break is now 
acceptable. If so, continue formatting from the end of Page 
1. Press Open Apple 0 and adjust the command line to read: 

[Continue] formatting at [this] page 

Press RETURN. The command line will successively read: 

Formatting Page 2 
Previewing page 2 

Page 2 is now ready for previewing and the cursor is 
positioned at the head of page 2 in the formatted document. 
Notice that Figure 1 has been moved from its original 
position at the end of paragraph 3 in the unformatted text, 
to the head of page 2 in the formatted document. This is 
because Figure 1 was created in a wide Reserved Field, and 
could not be formatted intact within a single column at the 
position designated in the unformatted text. For multi- 
column formatting, the Stemwriter program automatically 
fills the page with text from the remainder of the document 
and moves a wide Reserved Field to the top of the next 
formatted page unless it is already at the top of the 
current page. Thus, you can have a wide figure, table, etc, 
at the top of a page, with multi-column text filling the 
remainder of the page beneath the wide Reserved Field. 

You will also notice that Figure 2 is contained within 
the one column of text at the position designated in the 
unformatted text. This is because Figure 2 was created 
within a Reserved Field, with a Line Width less than the 
specified column width for the formatted text. For multi- 
column formatting, the Stemwriter program always formats a 
Reserved Field whose line width is equal to or less than the 
specified column width, intact in the current column. 
However, if a column break is calculated by Stemwriter to 
occur within the Reserved Field, this is not permitted to 
happen. Rather, the column is filled with text from the 
remainder of the document and the Reserved Field is moved to 
the top of the next column, following any wide Reserved 
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Fields. 

For single column formatting, if a Reserved Field 
cannot be formatted on the current page intact, the page is 
filled with formatted text from the remainder of the 
document and the Reserved Field is moved to the head of the 
next page. 

Remember, you specified that the Heading, Footing, Page 
Numbering, and page margins were to alternate. If you 
compare formatted page 1 with page 2, you will notice that 
the Heading, Footing, Page Numbers and page margins are on 
opposite sides of the text. 

As the layout of text on Page 2 is quite satisfactory, 
you can now complete the formatting process. Press Open 
Apple 0 and adjust the command line to read: 

[Continue] formatting at [this] Page 

Press RETURN. The file , /MYTEXT/FORMTEXT, will now be 
closed and the command line will read: 

Formatting Complete. 

The cursor is now positioned at the most recent position in 
the document from which the formatting was initiated. 

Suppose you now wish to print this formatted document 
on both sides of continuous forms paper. The normal way to 
do this, is to print all the odd-numbered pages, remove the 
paper and turn it over, re-insert the paper and print all 
the even-numbered pages. This is quite easy to do from a 
formatted file, but it is not possible from a formatted 
document. However, you can recover from the mistake of 
formatting to a document instead of a file by saving the 
formatted document to disk as a segmented file, as follows: 

Press Closed Apple 9 and adjust the command line to read: 

Display :: Window [A] : Document [2] 


Press RETURN. The cursor is now positioned in the formatted 
document, so press Closed Apple 7 and adjust the command 
line to read: 

[Save] [segt.] File [without] Encryption and [with ] Backup 
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Press RETURN and adjust the next command line to read: 

[Save] [all] [Page] as Segment 

Press RETURN. Display the pathname of the file to be saved, 
in this command line, as follows: 

Press RETURN. The formatted document will now be saved as a 
formatted segmented file, with each page occupying one 
segment, as though you had specified formatting to a file at 
the outset. 

10.5 Formatting From File To File 

When you format a file to a file, you must nominate two 
documents to act as scratchpads for the formatting process. 
In addition, you must nominate the pathnames of the file to 
be formatted and of the file to receive the formatted text. 
When formatting begins, the first page of the unformatted 
document is read from the nominated file on the disk into 
the specified scratchpad document in the computer's memory. 
This page is then formatted by the Stemwriter program and 
written into the scratchpad document you nominated to hold 
the formatted copy of the text. Thus, during formatting, 
there are always two associated active documents 
(scratchpads) in the computer's memory, one containing an 
unformatted page of text and the other containing the 
formatted copy of the same text. 

When formatting with Page Preview on, you are able to 
preview the formatted text in the scratchpad document, 
change the page break if you so wish and then re-format the 
page. Before Stemwriter formats page 2 of the nominated 
file, it writes page 1 of the formatted text to disk as 
segment 1 of the nominated segmented file, clears both 
scratchpads and then loads page 2 of the unformatted file 
into the appropriate scratchpad and formats it. The 
formatted copy of page 2 is then written into the scratchpad 
specified by you to hold the formatted text. The formatting 
process will continue until the entire nominated file is 
completely formatted and the formatted text is written to 
disk as a segmented file, with each formatted page being one 
segment. 

The Formatter will format either whole or segmented 
files and it treats segmented files as though they were 
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whole files for formatting purposes. Thus, if you had saved 
pieces of a very large document as segments of a segmented 
file, you would be able to format the segmented file in the 
normal way. All formatted files are written to disk as 
segmented files, with each formatted page being one segment. 
This enables you to print the pages in any order you desire, 
and as many copies of nominated pages as you wish. You may 
also print one or a few nominated pages without having to 
print the entire file (See Lesson 11.6.2). 

This exercise involves formatting the same file as we 
used in Lesson 10.4, viz: /MYTEXT/FORMTEXT, to the 
segmented file, /MYTEXT/FORMAT2, using Documents 8 and 2 as 
the scratchpads for the unformatted and formatted files, 
respectively. Format /MYTEXT/FORMTEXT, with Page Preview, 
Manual Hyphenation, Headings, Footings, and Page Numbering 
on. Also, format this file as two columns of fill- 
justified, single-spaced text with each column being 35 
characters wide and the inter-column margin being three 
characters. 

Preparation : Position the cursor in Document 1, if it is 
not there already, and clear Documents 2 and 8 (press Open 
Apple DELETE, etc). If you are following on from Lesson 
10.4, Documents 3 and 4 will already contain the Headings 
and Footings respectively. If this is not the case, go to 
lesson 10.4, and create the Heading and Footing documents as 
described therein, before continuing. Ensure that your user 
diskette, /MYTEXT, is in the boot drive of your Apple //e or 
//c. 


To begin the formatting process, press Open Apple 0 and 
adjust the command line to read: 

Print Format [File][8] to [File][2] [with ] Page Preview [Man.] Hyphenation 

This command line tells the Stemwriter program that you are 
going to format a file and write the formatted copy of the 
text to a segmented file, and to use Documents 8 and 2 of 
the computer's memory as scratchpads for holding pages of 
the unformatted and formatted text respectively. The 
Stemwriter program is to use manual hyphenation to format 
the text and it is to stop after formatting each page to 
allow Page Preview. 

Press RETURN and adjust the next command line to read: 

Line : Para Indent [5 ] Line Indent [0 ] Line Width [.35 ] 
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As the text will be formatted in two columns, this will give 
a column width of 35 characters. Press RETURN. The next 
command line will read: 

Page: LefttlO] HeadHl Foot!3] Margins on Sheet[A][Norm] Font[12] StyletA] 

Press RETURN and adjust the next line command line to read: 

Line Space [1 ] at [6] Line/Inch Paper Feed [Cent. ] Print Color [A] 

The text will be formatted as single spaced lines and it 
will be printed on continuous forms paper. Press RETURN and 

adjust the next command line to read: 

Heading from Doc.[3] with [Norm] Margins 


This command line tells the Stemwriter program to read the 
Heading text from Document 3 and to add it to the top of 
each formatted page. If you specify a non-existent document 
for the Heading text, the following error message will 
appear in the command line: 

Doc. not opened <Cont. on SPACE bar> 

On pressing the space bar, you are returned to the last 
valid command line, i.e. 

Heading from Doc.[3] with [Norm] Margins 

Before you can create the Heading text, you must press the 
ESCAPE key to quit the formatting process. 

Assuming all is well, press RETURN and adjust the next 

command line to read: 


Footing from Doc.[4] with [Norm] Margins 

This command line tells the Stemwriter program to read the 
Footing text from Document 4, and place it at the foot of 
each formatted page. If you specify a non-existent document 
for the Footing text, the same error message will appear in 
the command line as described above for non-existent Heading 
text. 

Again, assuming all is well, press RETURN and adjust the 
next command line to read: 
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First page#tJL 1 at line[2 ] of [Heading] and Col.tRgt] [Neon] Margins 

The first page of the formatted text will be numbered 1 and 
the Page Number will appear right-justified on Line 2 of the 
Heading margin on every page. Press RETURN and adjust the 
next command line to read: 

Text Justification[Fill] with [2] Text Columns [Norm] Margins 

The formatted text will be f ill-justif ied, i.e. the text 
will have smooth left and right margins. The text will also 
be formatted as two text columns per page with normal 
margins, i.e. the margins will be the same on every page, as 
is suitable for single-sided page printing. Press RETURN 


and adjust the 

next command 

line to 

read: 

Inter-Column Margins: 

1-213] 

2-3[3] 

3-4(3] 

The Stemwriter 

program 

will 

only use 

the inter-column margin 

information it 

needs. 

That 

is, in 

this case, only the 1-2 

Column Margin 
now read: 

data. 

Press 

RETURN. 

The command line will 

From! 




) 


You must now specify the pathname of the file to be 
formatted, in this command line. The prefix of the last 
used pathname will be displayed. If this is /MYTEXT, then 
skip the rest of this paragraph. Otherwise, press the left 
arrow until the shown pathname is deleted, and then press 
the down arrow key until you obtain: 


From[/MYTEXT 

] 


Press the right arrow key once 
arrow keys to adjust the second 
read: 

, and then use 
position of the 

the up/down 
pathname to 

From[/MYTEXT/FORMTEXT 

] 


Press RETURN. The command line will now read: 

To[/MYTEXT 

] 


You must now enter the pathname 
formatted text, as follows: 

of the file to 

receive the 

Tot/MYTEXT/FORMAT2 

1 
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The file, /MYTEXT/F0RMAT2, will be a segmented file with 
each segment being one formatted page of text. 

Press RETURN. The Stemwriter program will now begin to 
format the File, /MYTEXT/FORMTEXT, and the command line will 
read: 

Formatting Page 1 

As soon as the first word to be hyphenated is found, viz: 
'subsequent', the following will be displayed in the current 
text window: 

Move Cursor to break point. Accept with <RETURN> 

Hyphenate: subseq|uent 

You must manually position the cursor at the desired 
hyphenation point in the word. You cannot position the 
cursor beyond the vertical line, and the hyphen is always 
inserted immediately in front of the cursor position. Place 
the cursor on the vertical line in ' subseq | uent' and press 
RETURN. It will become 'subseq-uent' in the formatted text. 

The formatting of page 1 now continues until the next word 
to be hyphenated, 'highlighted', is found. The text window 
will now display: 

Move Cursor to break point. Accept with <RETURN> 
Hyphenate:highlig|hted 

Move the cursor so that it is positioned over the '1', and 
press RETURN. The word 'highlighted' will now become 'high¬ 
lighted' in the formatted text. The above procedure will 
continue until all words to be hyphenated on page 1 are 
dealt with. When page 1 is formatted and ready for 
previewing, the command line will read: 

Previewing Page 1 

The cursor will be positioned at the head of formatted Page 
1 in Document 2. Notice that the Reserved Field containing 
the Document name is correctly positioned, with two columns 
of text beneath it. Notice also that the columns have been 
correctly 'filled' with spaces to produce a smooth right 
margin. Although shown here as strategically introduced 
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spaces, the fill is actually evenly distributed over all the 
inter-word gaps, and if the formatted text is printed with a 
printer having micro-space control, the text will appear 
with the fill evenly distributed. Unfortunately, the screen 
display cannot do this, and it does the best it can. This 
is, however, exactly how the printed page will appear, if 
the formatted text is printed by a printer without micro¬ 
space control. 

You will also notice that the page Heading is centered, 
with the page number right justified in the second line of 
the Head margin. Check that the words you hyphenated are 
satisfactory. If you want to change the position of a 
hyphen in a word at this stage, you will have to re-format 
page 1 and hyphenate all the words on the page a second 
time. To do this, press Open Apple 0 and adjust the command 
line to read: 


[Continue] formatting at [prev] page 


Press RETURN. The command line will read: 


Formatting Page 1 

and the words to be hyphenated will appear successively on 

the screen for you to position the hyphen 

in them, as 

described above. When the formatting of page 
again, the command line will read: 

1 is complete 

Previewing Page 1 



Move the cursor to the end of the page. Notice that 
the Footnote is correctly positioned below the second column 
of text. If you compare with Formatting lessons 10.2, 10.3, 
and 10.4 (Appendix 1), you will see that the Footnote is 
correctly positioned at a different place in the formatted 
text in each case. Notice also that the Footing has been 
correctly added to the bottom of this page. Check that the 
position of the page break is acceptable. If not, then move 
the cursor to Document 8 (the unformatted text), adjust the 
scratch copy of the source text, and re-format page 1. 
Assuming that you are satisfied with the appearance of the 
formatted page, press Open Apple 0 and adjust the command 
line to read: 

[Continue] formatting at [this] page 


Press RETURN. The command line will now read: 
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Formatting Page 2 

The words to be hyphenated on Page 2 will now be 
successively shown on the screen, and you must hyphenate 
them as described for Page 1. When Page 2 is formatted the 
command line will read: 

Previewing Page 2 

The cursor will be positioned at the head of formatted Page 
2 in Document 2. Notice the Heading is again centered in 
the second line of the Head margin and the page number is 
right justified in the second line of the Head margin. 

You will also notice that as in Lesson 10.4, Figure 1 
has been moved from the end of paragraph 3 in the 
unformatted text to the head of Page 2 in the formatted 
text. This is because Figure 1 was created in a wide 
Reserved Field and the Stemwriter program automatically 
positions a Reserved Field wider than the text column width 
in multi-column formatting, at the top of the next formatted 
page, unless it is already at the top of a page. 

Figure 2 is also in a Reserved Field, but its width is 
less than the text column width. As it did not cross a page 
or column boundary, there was no need to move it. Had it 
crossed a boundary, this Reserved Field would have been 
moved to the head of the next column. 

The Footing of Page 2 is identical with the Footing of 
page 1, as expected. To continue formatting, press Open 
Apple 0 and adjust the command line to read: 

[Continue] formatting at [this] page 

Press RETURN. The last page of the formatted text is now 
written out, the source and destination files closed, and 
the scratchpad documents cleared. The command line will now 
read: 

Formatting Complete 

The file, /MYTEXT/FORMTEXT, has now been formatted to the 
segmented file, /MYTEXT/FORMAT2, each segment of which is 
one formatted page. This enables you to print all or any 
pages of the formatted file in any order, at will. 
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The cursor will now be placed at its most recent 
position in the document from which the formatting process 
was initiated. 

10.6 Special Fields And Formatting 

10.6.1 Comment Fields 

Comment Fields (including Classified Comment Fields) in 
the unformatted text are eliminated during the formatting 
process. Thus text formatted for printing NEVER contains 
Comments. Comments are NEVER printed irrespective of 
whether or not the text is formatted. 

The SPECIAL FIELDS: Underline, Bold, Footnote, Protected 
and Local are all terminated at a page break and re¬ 
initialized, if required, after the Heading has been printed 
at the top of the new page. Headings and Footings are 
completely separate from the formatted text on the page in 
that they have their own local environments which are 
specified by the documents from which they are drawn. 

10.6.2 Footnotes 

When Footnote text is formatted for printing, it is 
positioned at the end of the page in which the footnote 
marker occurs, just prior to the space at the bottom of the 
page allocated to the Footing. 

In text formatted for multi-column printing. Footnotes 
are positioned at the foot of the column of text containing 
the Footnote Marker. 

If the Footnote Marker is so close to the bottom of the 
current page or column that the Formatter calculates a page 
or column break to occur in the middle of the Footnote, the 
line containing the Footnote marker and the accompanying 
Footnote, is shifted to the next page or column 
respectively. 

10.6.3 Protected Fields 

The line width, line indent and paragraph indent 
settings for a Protected Field are those of the parent 
document which applied when you created the Protected Field. 
These settings are not modified by the formatting process 
and text in Protected Fields cannot be Fill justified. 
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10.6.4 Local Fields 

A Local Field in a document is formatted with the line, 
paragraph and page parameters you selected when you created 
the Local Field. Local Fields may be Fill justified in 
accordance with the selected Local Field line, page and 
printing parameters. 

In multi-column formatting, the Local Field line width 
CANNOT exceed the column width. If the Local Field line 
width is greater than the column width, the column width 
setting takes precedence and the Local Field is formatted 
accordingly. When a Local Field occurs in multi-column 
formatting the Line Spacing of the parent document prevails. 

10.6.5 Reserved Fields 

A Reserved Field in a document is formatted according 
to the line, paragraph and page parameters you selected at 
the time of creation of the Reserved Field. Reserved Fields 
may also be Fill justified in accordance with the selected 
Reserved Field line, page and printing parameters. If you 
attempt to force a new page within a Reserved Field during 
formatting with Page Preview, you will be prevented from 
doing so and the following error message will result: 

Sorry - Special Text Field 

If a Reserved Field cannot be formatted on the current 
page intact, the current page is filled with more text and 
the Reserved Field is moved to the beginning of the next 
page. For multi-column formatting, a Reserved Field which 
is equal to or less than the column width, which cannot be 
formatted intact in the current column, is moved to the top 
of the next column. Reserved Fields wider than the column 
width are permitted for multi-column formatting. A wide 
Reserved Field is positioned at the top of the next 
formatted page unless it is already at the top of the 
current page. Thus, you can have a wide table at the top of 
a page, with multi-column printing beneath the wide Reserved 
Field. 

10.6.6 Sticky Spaces 

'Sticky Spaces' are not filled during text formatting, 
when fill justified text is specified. Rather, they are 
treated as alphabetical characters. 


Lesson 10 



152 


Part 2 - Tutorial 


10.7 Supplementary Remarks 

The Tutorial lessons, 10.2, 10.3, 10.4, and 10.5 have 
introduced you to the essentials of formatting text for 
printing, using the Stemwriter program. Clearly, we did not 
use all the possible formatting permutations in these 
examples, and there were some parameters which we did not 
change. For example, we did not modify font size or style, 
and we only considered formatting for printing on continuous 
forms paper. The Headings and Footings we used were very 
simple. You may wish to experiment further with the various 
permutations of formatting settings possible. If you have 
successfully completed and understood these examples, you 
should, with the aid of the material in the Reference 
Section, be able to design just about any formatting layout 
for your text, that you desire. 
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11.0 LESSON 11 - PRINTING TEXT 

The Stemwriter program allows you to print both 
formatted and unformatted documents and files. Printing a 
document or file without first passing it through the 
Formatter is very useful for quickly printing draft copies 
of documents/files, simple letters that you don't want fill 
justified and so on. 

To print a document/file, press Closed Apple 6. All 
options of the print command (default options in the top 
line) are as follows: 

Print [Segt.] [File] with [saved] print data at [letter] speed 
[Whole] [Doc.] [new ] [draft ] 

If you print a whole or segmented file or a document (there 
is no difference between a whole and a segmented document), 
with [saved] print data such that it is printed with the 
same line, paragraph and page parameters that applied when 
you created that unformatted document/file. To print an 
unformatted document/file with different margins, line 
spacing, etc, to those used when you created the 
document/file, you must print it with [new] print data. 

While a document or file is being printed, you are 
locked out of it until its printing is complete. However, 
you may create or edit any other document in the computer's 
memory while the previously selected document or file is 
being printed. This is called BACKGROUND PRINTING, i.e. the 
Stemwriter program permits you to do other word processing 
tasks concurrently with printing. 

11.1 Ending The Printing Process Mid-Stream 

To stop the printing of a document/file before it is 
completed, press Open Apple 3. The message 

Printing Ended 

will appear in the command line and the printer will stop 
after the printer driver buffer has been flushed. This may 
take a few seconds as up to 200 characters may have to be 
printed. 
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11.2 Single Sheet Printing 

When you print a document/file using Single Sheets of 
paper, the printer halts for you to place the next sheet of 
paper in the printer. To continue printing the document or 
file, press Closed Apple 6. The next page of the 
document/file is then printed and the printer halts again 
for you to place the next sheet of paper in the printer. 
When you are ready, press Closed Apple 6 to print the next 
page. Continue this process until the document/file is 
completely printed. 

11.3 Temporarily Halting The Printer 

There are two ways to halt the printer, one is from a 
text file and the other is from the keyboard. To halt the 
printer temporarily from the keyboard, press Closed Apple 6. 
To re-start the printer, press Closed Apple 6 again. You 
might do this if you wanted to speak to somebody without the 
noise of the printer competing with you. 

The printer may be halted from a text file, e.g. to 
allow you to manually change the print wheel on a daisywheel 
printer at a specified place in the text. When you have 
done this, re-start the printer by pressing Closed Apple 6 
again. 

Irrespective of whether you halt the printer from a 
text file or from the keyboard, you can re-start it again by 
pressing Closed Apple 6. 

11.4 Synchronizing The Top Of The Paper With The Printer 

When you first switch the printer on, adjust the 
printer so that it is ready to print at the top of the page 
as the Stemwriter program automatically assumes that the 
printer is set to print at the top of the page. You can 
also synchronize the paper with the printer in the following 
way: 


Adjust the paper in the printer, so the printer is 
ready to print at the top of the page and press Open Apple 
6. The options of this command line are as follows: 

[Reset ] Printer to Page Head 
[Advance] 

Adjust the command line to read: 
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[Reset 3 Printer to Page Head 
Press RETURN. 

The Stemwriter program now knows that the printer is ready 
to print at the top of the page. To advance the printer to 
the top of the next page after printing a document/file, 
press Open Apple 6 and adjust the command line to read: 

[Advance] Printer to Page Head 


Press RETURN. 

The printer now advances to the top of the next page, 
irrespective of whether you are printing on continuous 
forms, cut sheets or single sheets. If there is no paper in 
the printer at the time, the roller or tractor feed 
mechanism of the printer moves forward the correct amount, 
such that when paper is inserted into the printer, the 
Stemwriter program assumes the printer is set at the top of 
the new page. 

11.5 Printing Documents 

The available printing options are: 

Print [Segt.] [Doc.] with [saved] print data at [letter] speed 
[Whole] [File] [new ] [draft ] 

When printing a document, it makes no difference whether 
[Whole] or [Segt.] is displayed in the command line as 
segmented and whole documents are exactly the same thing. 
However, segmented Files and whole Files are quite different 
from each other, as explained earlier in Lesson 8, which 
dealt with File Management. Formatted documents/files must 
be printed with [saved] print data and unformatted 
documents/files may be printed with either [saved] or [new] 
print data. If you have a dot matrix printer which can 
print at either [letter] or [draft] speed, then you can 
select whichever speed is applicable, in this command line. 
For daisywheel printers, the [letter]/[draft] portion of 
this command line is ignored. 

11.5.1 Printing Formatted Documents 

Preparation : Position the cursor in Document 1 (press 

Closed Apple 9) and clear all existing documents in the 
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computer's memory in the usual way (press Open Apple 
DELETE). Register the printer at a page head, as described 
in Lesson 11.4 by pressing Open Apple 6 and selecting the 
command line option: 

[Advance] Printer to Page Head 

Press RETURN. Ensure that your user diskette, /MYTEXT, is 
in the boot drive of your Apple //e or //c and load the 
formatted segmented file, /MYTEXT/FORMATS, which you created 
in Lesson 10.3, into the computer's memory as Document 1. 
To do this, press Closed Apple 7 and adjust the command line 
to read: 


[Load] [Segt.1 File [without] Encryption and [without] Backup 

Press RETURN. The command line will read: 

Load Segmentst 

1 


As we are going to load all segments (pages) 
adjust this command line to read: 

of 

this file. 

Load Segments[1..e 

3 


Press RETURN. The pathname command line will 

now 

read: 

Pathl 

] 


Using the arrow keys in the usual way, display the pathname 
of the file to be loaded, in the command line, as follows: 

Path[/MYTEXT/FORMATS 

] 



Press RETURN. Every segment of the file, /MYTEXT/FORMATS, 
will now be loaded into the computer's memory as Document 1, 
which you may now print as a formatted document. In the 
normal course of events, a formatted document would arise as 
a result of formatting from document to document, or from 
file to document. 

To print a formatted document, you must print it with 
[saved] print data, i.e. a formatted document is printed 
using the information embedded in the document when it was 
formatted. Press Closed Apple 6 and adjust the command line 
to read a permutation of the following: 
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Print [Segt.] [Doc.] with [saved] print data at [letter] speed 
[Whole] [draft ] 

Remember, there is no difference between segmented and whole 
documents. Press RETURN and adjust the command line to 
read: 

Print Whole Document [1] 

Press RETURN. The Stemwriter program will now begin to 
print Document 1. 

When Document 1 is being printed, the cursor is 
currently in this document and the command line will read: 

Display :: Window [A] : Documenttl] 

If you press RETURN, the message 

Document is Locked <Cont. on SPACE bar> 

will appear in the command line because you cannot edit a 
document while it is being printed. On pressing the space 
bar, you are returned to the command line: 

Display :: Window [A] : Document [1] 

Adjust this command line to select another document for 
creation or editing while Document 1 is being printed. 

If you accidentally try to print an unopened document, 
such as Document 6, the following error message will appear 
in the command line: 

Doc. not opened <Cont. on SPACE bar> 

On pressing the space bar, you are returned to the last 
valid command line, i.e. 

Print Whole Document [6] 

You can now adjust the command line to print the document 
you want, i.e. Document 1, the formatted document. 

If you try to print a formatted document with [new] 
print data, you will corrupt the previously formatted text 
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so that it is no longer properly formatted. 

11.5.2 Printing Unformatted Documents 

Preparation : Position the cursor in Document 2 (press 

Closed Apple 9). Advance the printer carriage to the head 
of the next page by pressing Open Apple 6 and adjusting the 
command line to read: 

[Advance] Printer to Page Head 

Press RETURN. Load the unformatted document, /MYTEXT 

/EX.DOC.1, into Document 2. To do this, press Closed Apple 

7 and adjust the command line to read: 

[Load] [whole] File [without] Encryption and [without] Backup 

Press RETURN. The command line will read: 

Path[ ] 

Using the arrow keys in the usual way, display the pathname 
of the file to be loaded, in this command line, as follows: 


Path [/MYTEXT/EX.DOC.1 ] 

Press RETURN. The unformatted file, /MYTEXT/EX.DOC.1, will 
now be loaded into the computer's memory as Document 2. 

You may print unformatted documents with either [saved] 
or [new] print data. If you choose to print with [saved] 
print data, the unformatted document will be printed with 
the same line, paragraph and page parameters you used to 
create it. To print Document 2 with [saved] print data, 
press Closed Apple 6 and adjust the command line to read a 
permutation of the following options: 

Print [Segt.] [Doc.] with [saved] print data at [letter] speed 
[Whole] [draft ] 

Press RETURN and adjust the next command line to show the 
document you want to print, i.e. 

Print Whole Document [2] 

Press RETURN. The printer will now print Document 2 using 
the page, paragraph and line break information you chose 
when you created this document. 
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When the printing of Document 2 is complete, print it 
again, but this time print it with [new] print data. 
Advance the printer carriage to the head of the next page 
(Open Apple 6). Press Closed Apple 6 and adjust the command 
line to read: 

Print [Segt.] [Doc.] with [new] print data at [letter] speed 
[Whole] [draft ] 

Press RETURN and adjust the next command line to read: 

Print Whole Document [2] 

Press RETURN. Now adjust the command line to display the 
[new] Page parameters you want to set, as follows: 

Page: Left[5 ] Head[4] FootU] Margins on Sheet [A] [Norm] Font[12J Style[A] 

This command line tells the Stemwriter program to print 
Document 2 with a left margin of 5 spaces, with Head and 
Foot margins of 4 single-spaced lines on sheet size [A] (as 
set up in the Stemwriter configuration program); all pages 
will be placed in the printer normally, i.e. not rotated on 
their side; print size will be 12 characters per inch and 
print style will be [A] (as defined in the Stemwriter 
configuration program). 

When these Page parameters are displayed in the command 
line, press RETURN. Now adjust the next command line to 
show the [new] Print parameters you want to set, as follows: 

Line Space [1.5] at [6] Line/Inch Paper Feed [Cent] Print Color [A] 

This commmand line tells the Stemwriter program to print 
Document 2 with 1.5 line spacing at 6 lines per inch; the 
paper feed into the printer will be continuous forms and the 
print color will be [A] (as set up in the Stemwriter 
configuration program). 

When these Print parameters are displayed in the command 
line, press RETURN. Document 2 will now be printed using 
the [new] print data you selected above. 

Printing unformatted documents is very useful for 
quickly producing drafts of documents for revision, simple 
letters, etc. That is, when full formatting of the document 
is not required. 
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11.6 Printing Files 

The Stemwriter program permits you to print Whole and 
Segmented files. Whole and Segmented files have already 
been defined in Lesson 8.1, if you wish to revise file 
types. 

11.6.1 Printing Whole Unformatted Files 

You may print a whole unformatted file from a disk, 
using [saved] or [new] print data. The [saved] print data 
are those line, paragraph and page parameters which applied 
when the file was created and saved to disk. 

Advance the printer to the head of the next page (press 
Open Apple 6) and ensure that your user diskette, /MYTEXT, 
is in the boot drive of your Apple //e or //c. Now print 
the file, /MYTEXT/FORMTEXT, as a whole unformatted file with 
[saved] print data. Press Closed Apple 6 and adjust the 
command line to read: 


Print [Whole] [File] with [saved] print data at [letter] speed 

[draft ] 


Press RETURN. The command line will now read: 


Path [ 


) 

Using the arrow keys in the 

usual 

way, adjust this command 

line to show the pathname 
follows: 

of the 

file to be printed, as 

Path [/MYTEXT/FORMTEXT 


J . .. --V 


Press RETURN. The file, /MYTEXT/FORMTEXT, is now printed 
with the line, paragraph and page parameters which applied 
when it was saved to disk as a file. Notice that the 
Footnote has not been positioned, there is no page 
numbering, and although Heading and Footing space has been 
allocated, it has been left blank. In short, the text has 
been printed 'as is'. 

To print this same unformatted file with [new] print 
data, press Closed Apple 6 and adjust the command line to 
read: 
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Print [Whole] [Filel with [new] print data at [letter] speed 

[draft ] 

Press RETURN. You must now select the new line and page 
parameters to be used for printing this file, in the next 
two command lines. You can choose new values for the left, 
top and bottom margins, the paper size, whether the paper is 
to be placed in the printer normal way up or rotated on its 
side, and the font size and style, as follows: 

Page : Left [5. ] Head [4^] Foot [ 3d Margins on Sheet [A] [Norm] FontE 12 ] Stylet A] 

Press RETURN and adjust the next command line to show: 

Line Space [2] at [6] Line/Inch Paper Feed [Cont] Print Color [A] 

This command line tells the Stemwriter program to print this 
file with double line spacing, at 6 lines per inch, on 
continuous sheets of paper, using print color [A], Print 
Color, Paper Size, and Print Font Style are all defined 


using the Stemwriter Configuration program. 

Press RETURN. The command line will now read: 

Path [ 

] 

Using the arrow keys in the usual way, 
of the file to be printed, as follows: 

display the pathname 

Path [/MYTEXT/FORMTEXT 

] 


Press RETURN. The file, /MYTEXT/FORMTEXT, will now be 
printed by the Stemwriter program, using the newly chosen 
line and page parameters. The text is printed 'as is', with 
the specified number of blank lines at the head and foot of 
each page. Again there are no Page Numbers, Headings or 
Footings on the printed page. Figure 1 has not been moved, 
and crosses a page break. This is unacceptable, and would 
not have occurred if we had formatted the text prior to 
printing it. Thus you can see that for relatively simple 
Documents and Files, you may print them unformatted with 
little or no adverse consequences. However, for more 
complex Documents and Files, containing Footnotes, Reserved 
Fields, and requiring Headers, Footers and Page Numbering, 
you must format them prior to printing them. 
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11.6.2 Printing Segmented Files 

You can print any number of individual segments, each 
as many times as you like, from formatted and unformatted 
segmented files. When you format a previously unformatted 
document/file to a disk file, the formatted text is 
automatically saved as a segmented file, with each formatted 
page being one segment. This enables you to print the pages 
of text in any order, to print multiple copies of pages, to 
print only one page, if you so wish, or to print the entire 
file. 


Advance the printer to the head of the next page (press 
Open Apple 6). Ensure that your user diskette, /MYTEXT, is 
in the boot drive of your Apple //e or //c and print the 
formatted file, /MYTEXT/FORMATS. Press Closed Apple 6 and 
adjust the command line .to read: 

Print [Segt.3 [File] with [saved] print data at [letter] speed 

[draft ] 

Press RETURN. The command line will now read: 

Prnt Segments [ ] 

You must now nominate the segments (pages) to be printed, in 
this command line. To print every page, i.e. from page 1 to 
the end of the file, adjust the command line to read: 

Prnt Segments [l..e ] 

This command line tells the Stemwriter program to print 
every segment in the file. If you need to recap further on 
the scheme for nominating segments, read Lesson 8.5 again as 
the procedure for loading segments is exactly the same as 
that for printing segments. Useful segment printing 
commands are: 

Prnt Segments! l..e[2] ] Prints all odd pages 

Prnt Segments! 2..e[2] ] Prints all even pages 

Prnt Segments[3,10 ] Prints pages 3 and 10 only 

When the segments (pages) you want to print are displayed in 
the command line, press RETURN. The command line will now 
read: 

Path [ ) 
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Using the arrow keys in the usual way, display the pathname 
of the file to be printed, as follows: 

Path [/MYTEXT/FORMATS ] 

Press RETURN. All pages of the formatted file, /MYTEXT 
/FORMATS, will now be printed. 

11.6.3 Printing Unformatted Segmented Files 

Unformatted segmented files may be printed using 
[saved] or [new] print data. Advance the printer to the 
head of the next page by pressing Open Apple 6. Ensure that 
your user diskette, /MYTEXT, is in the boot drive of your 
Apple //e or //c, as there are two examples of unformatted 
segmented files on this diskette. Try printing the 
unformatted segmented file, /MYTEXT/ARTICLES. To print an 
unformatted segmented file with the same line, paragraph and 
page settings which applied when it was saved to disk, press 
Closed Apple 6 and adjust the command line to read: 


Print [Segt.] [File] with 

[saved] print data at [letter] speed 
[draft ] 

Press RETURN. The command line will now read: 

Prnt Segments [ 

] 

You must now nominate 

the segments you want to print, e.g. 

Prnt Segments [l..e 

] 


This command line tells the Stemwriter program to print all 
segments in the file, /MYTEXT/ARTICLES, from segment 1 to 
the end of the file. 


Press RETURN. The command line will now read: 

Path [ ] 


Using the arrow keys in the usual way, display the pathname 
of the segmented file to be printed, as follows: 

Path [/MYTEXT/ARTICLES ] 

Press RETURN. 


Lesson 11 



164 


Part 2 - Tutorial 


The Stemwriter program will now print every segment of the 
unformatted segmented file, /MYTEXT/ARTICLES, from segment 1 
to the end of the file. Notice that the text inside the 
Comment Fields is NOT printed as Comments are NEVER printed. 

When the printing is complete, advance the printer to the 
head of the next page (press Open Apple 6), and print this 
file again with [new] print data. To print an unformatted 
Segmented File with [new] print data, i.e. with different 
line and page break information to that which applied at the 
time the Segmented file was saved, press Closed Apple 6 and 
adjust the command line to read: 

Print [Segt.][File] with [new] print data at [letter] speed 

[draft ] 

Press RETURN and adjust the command line to show the new 
page parameters you want, as follows: 

Page: Left [2! ] Head[4] Foot!4] Margins on Sheet[A][Norm] Font[12] StyletA] 


This command line tells the Stemwriter program to print the 
file, /MYTEXT/ARTICLES, using a left margin of 2 spaces. 
Head and Foot margins of 4 single-spaced lines on sheet size 
[A] (as defined in the Stemwriter configuration program), 
with each sheet of paper placed normally in the printer, 

with print size of 12 characters per inch and print style 

[A] (as defined in the Stemwriter configuration program). 

When these page parameters are displayed in the command 

line, press RETURN. Now adjust the next command line to 
show the Print parameters you want, as follows: 

Line Space [1.5] at [6] Line/Inch Paper Feed [Cent] Print Color[A] 

This command line tells the Stemwriter program that the 
nominated file will be printed with 1.5 line spacing at 6 
lines per inch on continuous forms paper with print color 
[A] (as defined in the Stemwriter configuration program). 

When these print parameters are displayed in the command 

line, press RETURN. The command line will now read: 

Prnt Segments [ ] 

You must now nominate the segments to be printed in this 
command line, as follows: 
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Prnt Segments [l..e[2] 


] 

Press RETURN. The command line will now read: 

Path [ 


] 

Using the arrow keys in 

the usual way, 

display the pathname 

of the Segmented File to 

be printed, as 

follows: 

Path [/MYTEXT/ARTICLES 


] 


Press RETURN. 


The odd numbered segments, i.e 1,3,5,... of the Segmented 
file, /MYTEXT/ARTICLES, will now be printed, using the [new] 
page and print information specified above. 

11.6.4 Printing Whole Formatted Files 

Had you inadvertently saved a formatted document as a 
whole file, you would print it as follows: Press Closed 

Apple 6 and adjust the command line to read: 

Print [Whole] [File] with [saved] print data at [letter] speed 

[draft ] 

Press RETURN. Using the arrow keys in the usual way, 
display the pathname of the whole unformatted file (if such 
a file existed), to be printed, as follows: 

Path [/MYTEXT/FILEF0RM1 ] 

Press RETURN. 

The nominated file, FILEF0RM1, would now be printed, if it 
existed. 
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12.0 LESSON 12 - FILLING IN STANDARD FORMS 

The Stemwriter program will allow you to fill-in 
Standard Forms; such as Invoices, Delivery Dockets, Taxation 
Forms, Letter Templates, and so on. You can fill-in pre¬ 
printed Forms, or you can create and fill-in your own Forms. 
The Stemwriter program can create fill-in Forms because it 
supports various Special Fields, such as Protected Fields, 
which you cannot alter in any way. Comment Fields which 
remind you what to do next. Local Fields for setting Local 
Environments in documents, etc. For a full discussion on 
Special Fields, read Lesson 7.0 again. 

12.1 Designing A Form Template 

Irrespective of whether the Standard Forms you wish to 
fill-in are pre-printed or blank, you must firstly create an 
electronic template of the Form, before you can fill it in. 

12.1.1 For A Pre-Printed Form 

Firstly measure up the Form. Suppose it is 12" x 8". 
Ensure that you have associated this page size with Sheet 
[A], [B], [C], or [D] by using the Stemwriter Configuration 
program. You must now work out how many line spacings 
(length) and character positions (width) this Form size 
corresponds to. It will depend on whether your printer 
prints at 6 or 8 lines per inch, and on the font size you 
are printing with, i.e. 10, 12, or 15 characters per inch. 
Suppose your printer prints at 6 lines per inch and you are 
using a 12 character per inch font. In terms of single line 
spaces and character width, the dimensions of your standard 
12" x 8" Forms are 72 lines by 96 characters. 

Now calculate the position of the parts of the Form to 
be filled in, in terms of line spaces and characters. 
Assume that the Head Margin at the top of the document you 
are creating the Form Template into, is 3 single spaced 
lines (the default value). When you have done this, you are 
ready to create your electronic template. 

12.1.2 For A Blank Form 

In addition to defining the dimensions of the Form, and 
the position of the parts of the Form to be filled in, in 
terms of line spaces and characters (length and width 
respectively), as described above for a pre-printed Form, 
you must also create the standard text to be printed on 
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every Form. The text to be printed on every Form will be 
placed in a Protected Field in the electronic Form Template, 
so that it cannot be modified in any way. You should now be 
ready to create the electronic template. 

12.2 Creating An Electronic Template 

Position the cursor in a clear Document in the 
computer's memory, in the usual way, e.g. in Document 8. If 
you create the whole Template within a Local Field, i.e. 
with its own local environment, it will always be 
independent of the Document in which it is currently 
residing. This is very important, because when you save the 
electronic template to disk, you will be able to load it 
into any other Document at some future time without having 
to worry about page dimensions, etc. To begin a Local 
Field, press Closed Apple 4 and adjust the command line to 
read: 


[Begin] [Local ] Field 

Press RETURN and adjust the next command line to read: 


Page: Left[15] Head[3] Foot [3] Margins on Sheet [B] [Norm] Font[12] Stylet A] 

Head and Foot Margins in Local Fields are ignored, as the 
Global Head and Foot Margins of the Document take 
precedence. The Left Margin of the Local Field will be 15 
characters on Sheet B, whose dimensions you should have 
already defined using the Stemwriter Configuration program. 

Press RETURN and adjust the next command line to read: 

Line Space [1 ] at [6] Line/Inch Paper Feed[Cont] Print Color[A] 

Remember! You calculated the standard forms dimensions in 
terms of single spaced lines at 6 lines per inch. 

Press RETURN. The symbol,^, will now appear in inverse 
video at the upper left-hand corner of your current screen 
window, designating the beginning of the Local Field. 

At this point, it would be a good idea to place a non¬ 
printing Comment, identifying the specific Form Template, at 
the top of the Document. To do this, press Closed Apple 4 
and adjust the command line to read: 

[Begin] [Comment] Field 
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Press RETURN. The Symbol, —will now appear on the screen 
in inverse video, right beside the Begin Local Field Symbol, 
to mark the beginning of the Comment Field. Now type the 
Comment text, e.g. 'This is a fill-in Form for sending out 
invoices. All parts of this Form, except for the fill-in 
spaces, are contained in Protected Fields. ' To end the 
Comment Field, press Closed Apple 4 and adjust the command 
line to read: 

[End ] [Comment] Field 

Press RETURN. The symbol,*—, will now appear on the screen 
in inverse video, marking the end of the Comment Field. To 
this point, your current screen window should resemble: 

Z \—>This is a fill-in Form for sending out invoices. All 
parts of this Form, except the fill-in spaces, are contained 
in Protected Fields.*— 


The next three paragraphs describe how to create the 
standard text in the correct position for Forms which are 
not pre-printed. Remember, the standard text in the Form 
must go inside a Protected Field so that it cannot be 
altered. If for any reason, you want to adjust text within 
a Protected Field, you must firstly turn the Field Markers 
off by pressing Open Apple 4 and adjusting the command line 
to read: 

Turn Special Field Markers [off] 

Press RETURN. Until the Field markers are turned on again, 
the Protected Field markers will be inactive. Remember, the 
standard text in the Form must go inside a Protected Field. 
To begin a Protected Field, press Closed Apple 4 and adjust 
the command line to read: 

[Begin ] [Protect ] Field 

Press RETURN. The symbol, 1 , will now appear on the screen 
in inverse video, right beside the end Comment Field marker, 
to denote the beginning of the Protected Field. To create 
the Form Heading, press the RETURN key once to make a new 
line and type the Form Heading as follows: 

ABC MANUFACTURING CORPORATION 
ACME UTILITIES DIVISION 
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Now Center both lines of text using the Line Adjust command. 
Press Closed Apple 5 and adjust the command line to read: 

Align text by {line] 

Press RETURN. Now press C to center the second line 
(containing the cursor) of the heading text. Press the up 
arrow key once. The first line of the heading will now also 
be centered. Press ESCAPE to quit the Line Adjust command. 
Now move the cursor to the document tail (press Closed Apple 
8, etc) and press the RETURN key twice to create two blank 
lines. 


The next thing is to draw a box for the customer's name 
and address at the top of the Form. Horizontal lines can be 
drawn by pressing SHIFT in conjunction with the hyphen key 
in the top row of the keyboard. Similarly, vertical lines 
can be drawn by pressing SHIFT in conjunction with the 
backslash key. 

To begin, clear all existing tabs from Document 8. To 

show the tab stops, press Open Apple Tab and adjust the 

command line to read: 

[Show] Tabs 

Press RETURN and adjust the next command line to read: 

Tab Display [on] 

Press RETURN. Now press Open Apple Tab and adjust the 

command line to read: 

[Clear] Tabs 

Press Enter and adjust the next command line to read: 

Clear [All] Tab from Coltl] 

Press RETURN. Now set 2 tabs at columns 20 and 50 by 

pressing Open Apple Tab and adjusting the command line to 
read: 


[Set] Tabs 

Press RETURN and adjust the next command line to read: 

Set 12 ] Tab at Col[^0] Step[_30] Align Chr[^ ] 
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Press RETURN. Two tab stops at columns 20 and 50 (20+30) 
will now be displayed on the ruler at the top of the current 
screen window. Press the Tab key once to position the 
cursor at Column 20. Draw a horizontal line (SHIFT-HYPHEN) 
until column 48 is reached and press RETURN. Now move the 
cursor to Column 15 by pressing the Tab key once and then 
backspacing 5 characters. Type the word 'To' followed by a 
colon. Press Tab again to move the cursor to column 20. 
Type one vertical slash (SHIFT-backslash). Before you can 
create the first line in the fill-in box for the Customer's 
Name and Address, you must end the Protected Field. Press 
Closed Apple 4 and adjust the command line to read: 

[End ] [Protect ] Field 


Press RETURN. Now press Tab again to move the cursor to 
column 50. Begin the Protected Field once more by pressing 
Closed Apple 4 and adjusting the command line to read: 

[Begin] [Protect ] Field 


Press RETURN. Now type a vertical line (SHIFT-backslash). 
The vertical lines are being used to draw the sides of the 
box enclosing the customer's name and address, so they must 
be enclosed within Protected Fields. Press RETURN to move 
the cursor to the head of the next line and press Tab to 
position the cursor at column 20. Type a vertical line and 
then end the Protected Field in the usual way. We are now 
creating the second line in the Fill-in box for the 
customer's name and address. Press Tab to position the 
cursor to column 50, begin the Protected Field again, type 
the vertical line to signify the end of the fill-in line and 
then press RETURN. You must now create 3 more lines in the 
fill-in box for the customer's name and address as described 
above, so that there are a total of 5 lines in this box. 
The cursor should be positioned in column 1 on a new line, 
when you have done this. You must now draw the horizontal 
line for the bottom of the box. Press Tab to move the 
cursor to column 20. Type the underline character (SHIFT- 
HYPHEN) until you reach column 48. Press RETURN. The box 
for the customer's name and address is now complete. 

Press the RETURN key twice to create two blank lines 
and type the word 'Date', followed by a colon. Now end the 
Protected Field and press the space bar 20 times. This 
creates the box for the Date to be entered. Begin the 
Protected Field and move the cursor to column 45 (Press Tab 
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and backspace 5 characters). Type the words 'Invoice No' 
followed by a colon. End the Protected Field and press the 
space bar 8 times. Begin the Protected Field again. The 
box for the Invoice Number has now been created. Press 
RETURN twice, move the cursor to column 5 and type the word 
'Items'. Now move the cursor to column 59 and type the word 
'Cost'. Press the RETURN key once. 


Before proceeding further, you must clear the existing 
tab stops and set two new ones. Press Open Apple Tab and 
adjust the command line to read: 


[Clear] Tabs 

Press 

RETURN and adjust the 

next 

command line 

to read: 

Clear 

[All] Tab from Coltl 

] 



Press RETURN. To set two 

Tab and adjust the command 

new 

line 

tab stops, press Open Apple 
to read: 

[Set] 

Tabs 




Press 

RETURN and adjust the 

next 

command line 

to read: 

Sett 2: 

] Tab at Col[55] Step[13] 

Align Chr[j_ J 



Press RETURN. Two tabs at columns 55 and 68 (55+13) will 
now be displayed on the ruler at the top of the screen. 


The next thing to do, is to draw a horizontal line 
across the screen from column 1 to column 64. This will 
separate the Customer information from the Item information. 
Even though the Special Field characters are shown on the 
screen, they are not printed, nor are they counted for 
printing purposes. So, even though lines may not appear to 
join on the screen, they will be joined when the Form is 
printed. 

When the horizontal line is drawn, press RETURN and 
type a vertical slash. Now end the Protected Field and 

press the Tab key once to move the cursor to column 55. 
Begin the Protected Field, type a vertical slash and end the 
Protected Field. Press Tab again to move the cursor to 

column 68. Begin the Protected Field and type a vertical 

slash. You have now created the first line for the 'Item' 

and 'Cost' portion of the Invoice. Now create another 
twelve lines in exactly the same manner as that just 
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described for the first line, beginning 'press RETURN'. 
When you have done this, the cursor should be positioned on 
the righthand edge of the thirteenth line. Press RETURN, 

type a vertical slash and end the Protected Field. Press 

Tab, begin the Protected Field, type a vertical slash 
followed by ten underline characters and another vertical 
slash. Press RETURN. Type a vertical slash and end the 
Protected Field. Move the cursor to column 47, begin the 
Protected Field, and type the word 'Total'. Press Tab once, 
end the Protected Field, press Tab again, begin the 
Protected Field and type a vertical slash. Press RETURN and 
type another vertical slash. Now draw a horizontal line 
right across the Form to column 64. Type a vertical slash. 

Now, all that remains is to close the Special Fields, 
force a New Page at the end of the Form, and turn the 

Special Field markers back on. To do this, press RETURN, 

end the Protected Field, end the Local Field and press 
Closed Apple 3 to force a new page for the next Invoice. 
Finally, press Open Apple 4 and adjust the command line to 
read: 

Turn Special Field Markers [on ] 

Press RETURN. 

Congratulations! You have now created an electronic 
template for printing Invoices. Save this template in the 
usual way, with the pathname /MYTEXT/INVOICE. FILL. Now 
position the cursor in Document 7, and load the file, 
/MYTEXT/FORMFILL into this document. Compare it with the 
Invoice template you have just created in Document 8. They 
should be very similar. How did you go? 

12.3 Filling In Forms 

This exercise allows you to fill in Forms, print them, 
and save the filled in forms in a segmented file on your 
diskette, /MYTEXT. This will give you a printed copy as 
well as a filed electronic copy of each Invoice. 

Position the cursor in Document 7, if it is not there 
already. It should currently contain a copy of the file, 
/MYTEXT/FORMFILL, which will be used in this exercise for 
filling in forms. Have a close look at this Form. At the 
top is the identifying Comment which will not be printed. 
The only parts of this Form which are not enclosed within 
Protected Fields are the parts which you are to fill in. 
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i.e. the boxes for Customer Name and Address, the Date, the 
Invoice Number, and the column headings, 'Items' and 'Cost'. 
Within the body of the invoice, the outlines are placed 
within Protected Fields, as is the word, 'Total'. The 'New 
Page' directive at the end of the Form, forces the printer 
to move to the head of the next Form after printing the 
current Form. 

The first step required for filling out a series of 
Invoices using the electronic template in Document 7, is to 
place the entire Form within 'Copy' markers. Jump to the 
head of the Document (press Closed Apple 8, etc), press Open 
Apple 2 and adjust the command line to read: 

[Copy] text by [Block] 

Press RETURN. Position the first copy marker at the head of 
the document. Jump to the tail of the document, and set the 
second copy marker. 

Now position the cursor in Document 1 (press Closed 
Apple 9, etc) and clear it if necessary. Press Closed Apple 
2 and the first copy of the electronic template in Document 

7 should now be in Document 1. Fill in the template as you 

wish. When you need a fresh copy of the Invoice Template, 
jump to the tail of Document 1, and press Closed Apple 2. A 

fresh copy of the Invoice will be added to Document 1, 

following the first copy. Every time you need a fresh copy, 
repeat the above two steps. Continue creating and filling 
in Invoices in this manner, until you have filled in 
approximately ten Invoices. Now save Document 1 as a 
segmented file. Press Closed Apple 7 and adjust the command 
line to read: 

[Save] [segt.] File [without] Encryption and [with ] Backup 

Press RETURN. All of the options for the next command line 
are: 

[Save] [this] [para] as Segment 
[Add ] [all ] [page] 

If this is to be a new file, adjust the command line to 
read: 


[Save] [all ] [page] as Segment 

If you are going to add segments to a pre-existing file. 
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adjust the command line to read: 


[Add 3 [all] [page] as Segment 

Press RETURN. You must 

now 

nominate 

the 

pathname 

of the 

segmented file to receive 
line, as follows: 

the 

Invoices, 

in 

the next 

command 

Path!/MYTEXT/INVOICES 




] 



Press RETURN. The filled-in invoices will now be saved to 
the segmented file, /MYTEXT/INVOICES, with each segment 
being one Invoice. 


To print the completed invoices, press Closed Apple 6 
and adjust the command line to read: 

Print [whole][Doc] to [parallel] printer with [saved ] print data 

Press RETURN and adjust the next command line to read: 

Print whole Document [1] 

Press RETURN. The Invoices will be printed and the command 
line will read: 

Display :: Window [A] : Document [1] 

Adjust this command line to show Document [2] and press 
RETURN. 

Clear Document 2 if it is not already clear, and press 
Closed Apple 2 to create the first Invoice template in 
Document 2. Proceed to fill-in and create invoices in 
Document 2, as was done for Document 1, while the printer is 
busy printing the filled-in Invoices in Document 1. 

Save the filled-in Invoices in Document 2, by adding 
them as additional segments to the file, /MYTEXT/INVOICES. 
To do this, press Closed Apple 7, adjust the first command 
line as previously, press RETURN to accept it, and then 
adjust the second command line to read: 

[Add ] [all] [page] as Segment 

Press RETURN. Nominate the same pathname as previously, and 
the filled-in invoices in Document 2 will now be added to 
the Invoice File. By this time, the Invoices in Document 1 
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should all be printed out. Commence printing Document 2. 
While the printing of Document 2 is in progress, move the 
cursor back into Document 1, clear it, and create and fill- 
in fresh Invoice templates as before. In this way, you can 
be continually filling in, saving and printing invoices by 
switching between Documents 1 and 2 until all the invoices 
have been processed. 
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13.0 LESSON 13 -WRITING LETTERS 

Preparation : Position the cursor in Document 1, clear it in 
the usual way and load the unformatted file, /MYTEXT/LETTER, 
into this document of the computer's memory. The cursor 
will be positioned at the head of the document. 

13.1 Letterhead Paper 

Notice that a one inch (6 single spaced lines at 6 
lines per inch) Reserved Field has been set at the top of 
the document. This is precisely the same size as the 
Letterhead of the stationery on which this letter is to be 
printed. This means that the printer will keep its proper 
registration with the paper length even when you print a 
multi-page letter, with just Page 1 being printed on 
letterhead paper. 

13.2 Entering The Date 

Move the cursor to the Date and delete it. To enter 
today's date into the letter, position the cursor at a point 
in the letter where you would like the date to start, cut 
the text by pressing Closed Apple 0 and press Closed Apple 
with D (User Key D) . Today's date will now be entered into 
the letter. Rejoin the text by pressing Closed Apple 0 
again. User Key D is always initialized with the current 
date when you set the date at start-up time. 

13.3 Indented Text In The Body Of A Letter 

Move the cursor to the head of paragraph 5, beginning 
'The Busy-Bees....'. Paragraph 5 is contained in a Local 
Field with its own Left Margin, Paragraph Indent, Line 
Indent, Line Width, Font Size and Style, and Line Spacing. 
The Para Indent of the Local Field is 11 characters compared 
to 5 characters in the remainder of the document, the Line 
Indent is 6 characters compared to 0 characters and the Line 
Width is 60 characters compared to 72 characters in the 
remainder of the document. This is how the indented 
appearance of paragraph 5 is achieved. 

13.4 Letters Consisting Of Two Or More Pages 

For letters which are two or more pages long, you might 
like to have the Footing 'Continued...' appear right 
justified in the Foot Margin on all but the last page. To 
do this, you must create a separate Footing Document 
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containing the right justified Footing text, 'Continued...'. 

When you format such a letter for printing, you must do 
so with Page Preview on. If the pages are to be numbered as 
well, you must specify Page Numbering to be on and manually 
remove the number from the first page of the formatted 
letter. There is only one way for you to do this. When the 
first page is shown for previewing, the cursor is at the 
head of the formatted page. Move the cursor so that it is 
one or two characters preceding the page number. Press Open 
Apple 8 and adjust the command line to read: 


[Replace ] Designated Word/String 

Press 

RETURN 

and adjust the next command line 

to read: 

Srch : 

: Dir[>] 

: Countfl ] : BoundtPara] : Case [Any] : 

ModetLit ] 

Press 

RETURN 

and adjust the next command line 

to read: 

F [1 



] 

Press 

RETURN 

and type one space in the next command line: 

R [ 



] 

Press 

RETURN 

. The Stemwriter program will now 

automatically 


replace the page number, 1, with a space. 

Continue formatting the letter. When the second-last 
page is being previewed, move the cursor to the Document in 
the computer's memory containing the Footing text (usually 
Document 4). Position the cursor in the Footing text, and 
press the space bar until all of the Footing text has been 
replaced by spaces. Now continue formatting the letter. 
The last page will not have the Footing 'Continued....' in 
its Foot Margin. 

13.5 Creating An Address List 

Before you can generate Form letters, you must firstly 
create an appropriate Address List. The Address List must 
be a segmented file, where each segment is one address and 
all segments are separated by the new paragraph indicator. 
When creating the segments, don't forget to set the 
Paragraph Indent to zero. Each address must contain the 
appropriate Classified Comment Fields which may contain 
pertinent details for each individual addressee. The 
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Classified Comment Fields do not necessarily have to be the 
same categories for each addressee. 

Position the cursor in a clear document and load the 
example Address List into the computer's memory from the 
file, /MYTEXT/MAIL.LIST, in the usual way. You will notice 
that each address in this particular address list has three 
Classified Comment Fields associated with it, viz: Product 
type, salutation to be used in each Form Letter and zipcode. 
You will also notice that there are no spaces or line breaks 
between the Classified Comments. This is because any such 
spaces or line breaks would appear in the body of the 
address, as all text in the address segment not contained in 
Classified Comment Fields is considered as belonging to the 
Class key 'ADDRESS' by the Form Letter generator. N.B : The 
Class Key 'ADDRESS' is always in uppercase characters. 

The only restriction on the position of the Classified 
Comment Fields in each address segment, is that they must 
occur within the first 512 characters of the segment, or 
they will be ignored. This free field approach gives you 
considerable freedom in designing Class Keys and keywords to 
be used with individual segments (addresses in this case). 

Thus, using a combination of Classified Comment Fields 
and segmented files, you have a very powerful and efficient 
means at your disposal for creating free-form records of 
arbitrary size, which you can file and retrieve, in a simple 
manner, at will. 

13.6 Form Letter Generation 


You can create personalized Form Letters using the 
Stemwriter program. Firstly, you must create a Form Letter 
template in which are one or more Classified Comment Fields. 
Then, when the Form Letter generation begins, the Stemwriter 
program reads the appropriate entries for the various 
Classified Comment Fields from a nominated segmented file 
(Address List) into the body of the letter in the 
appropriate places. The generated letters are then written 
sequentially as they are created to a nominated whole file. 
You can then print the file containing the Form letters, as 
a background task, if you so wish, while you use the 
Stemwriter program for other duties. 
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13.6.1 Making The Template 

Position the cursor in a clear document in the usual 
way. A suitable Form better template may be loaded into the 
computer's memory from the file, /MYTEXT/FORMLETTER. 
Alternatively, you may elect to create the template 
yourself. If so, proceed as follows: 

The cursor should be in the upper lefthand corner of 
your screen and you are now ready to create the Form letter 
template. Press Closed Apple D. Today's Date will appear 
on your screen as follows: 

October 12, 1985 

To adjust the date to be flush with the righthand margin, 
press Closed Apple 5, select 

Align Text by [Line ] 


and press RETURN. Then press R followed by ESCAPE. The 
current date will now appear right justified on your screen 
as follows: 

October 12, 1985 

Press the RETURN key twice to create two blank lines. You 
must now enter the first Classified Comment Field which is 
for the Addressee's address. Classified Comment Fields in 
Form Letter templates always comprise Class Key only. When 
the Form Letter generator reads the Class Key, it replaces 
the Class key entry in the letter template by the associated 
keyword from the address file. Remember! The Class Key, 
'ADDRESS' must always be in uppercase characters. Now, 
press Closed Apple 4 and adjust the command line to read: 

[Begin] [Comment] Field 


Press RETURN. Type the less than sign, <, followed by the 
uppercase word, ADDRESS, followed by the greater than sign, 
>. You must now close the Classified Comment Field. Press 
Closed Apple 4 and adjust the command line to read: 

[End] [Comment] Field 


To this point, your Form letter template should read as 
follows: 
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October 12, 1985 

-4 <ADDRESS><— 

Press the RETURN key twice to create two blank lines and 
enter 'Dear -4<SALUT>4—'. To do this, type the word 'Dear', 
followed by a space. Then press Closed Apple 4 and adjust 
the command line to read: 


[Begin] [Comment] Field 


Press RETURN. Type the less than sign, <, followed by the 
word, SALUT, followed by the greater than sign, >. To close 
this Classified Comment Field, press Closed Apple 4 and 
adjust the command line to read: 

[End] [Comment] Field 

Press RETURN. Press the New Paragraph command (Closed Apple 
1) and type the following: 

I am writing this letter to congratulate you on the 
excellent —»<PRODUCT>sales you achieved last month. If 
you continue to achieve such good sales for the rest of the 
year, -4<SALUT><—, you will find a substantial bonus in your 
end of year paycheck. 

Now remember our Company's motto, -4<SALUT><-, "IN HOME 
PRODUCTS BELONG IN HOMES". 

Keep up the good work. 


Kind Regards 


Big Boss 

In Home Selling Inc. 

You must end the template with the New Page directive 
(press Closed Apple 3, once). The new page directive will 
appear at the bottom of your Form Letter template as the 
Open Apple symbol. 
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13.6.2 Generating Form Letters 

The Stemwriter program generates personalized Form 
Letters by reading records from Classified Comment Fields in 
a nominated segmented file into the body of the Form Letter 
template in the appropriate places. The formatting of the 
generated Form Letters is checked in turn as they are 
created by the Stemwriter program and they are then written 
to a nominated whole file. The generated file of Form 
Letters can then be printed as a background task, if you so 
wish, while you continue to use Stemwriter for other duties. 

Ensure that you know which document of the computer's 
memory that the Form Letter template is in and that there 
are two clear documents available to act as scratch areas 
for the Form Letter generator. For example, the Form Letter 
template may be in Document 1 and Documents 2 and 3 may be 
available for use as scratch areas. 

To generate Form Letters using the Form Letter template 
you have just created, and the Address List in the file, 
/MYTEXT/MAIL.LIST, press Open Apple 5 and adjust the command 
line to read: 

Template from Doc [1] using Address File [2] to File [3] 

This command line tells the Stemwriter program that the Form 
Letter template is in Document 1 of the computer's memory 
and that Documents 2 and 3 are to be used as scratch 
documents for the Form Letter generation. 


Press RETURN. The next 

command line will read: 


From [ 

1 


Using the arrow keys in the usual way, adjust this command 
line to show the name of the segmented Address file to be 
used in the Form Letter generation, as follows: 

From [/MYTEXT/MAIL.LIST 

] 


Press RETURN and adjust the next command line to show 
name of the file the generated Form Letters are to 
written to, e.g. 

the 

be 

To [/MYTEXT/LETTERFORMS 

] 



Press RETURN. The Stemwriter program now begins to process 
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the Form Letters using the Form Letter template in Document 
1 and the address file, /MYTEXT/MAIL.LIST. While the Form 
Letters are being generated, the message 

Stemwriter is busy.. 

will be displayed in the command line. 

When all the Form Letters have been generated and 
written to disk as the file, /MYTEXT/LETTERFORMS, the 'busy' 
message disappears from the top of the current window and 
the cursor re-appears on your screen. You may now print the 
Form Letters immediately or you can print them at a later 
time. Remember that the Stemwriter program supports 
Background printing so that you can print the Form Letters 
while you are using the Stemwriter program to do other 
tasks. 

13.6.3 Slightly Different Letters 

Because the Stemwriter program permits up to 8 
different documents to reside in memory simultaneously, you 
can have up to 6 different Form Letter templates, each of 
which is slightly different, in the computer's memory at 
once. This leaves the necessary two clear documents 
available for use as scratch documents in the Form Letter 
generation. If you are going to send slightly different 
letters to some of the people on your Address List, the 
Stemwriter Utilities enable you to sort and select entries 
in your Address List in the desired way and to create 
'daughter' Address Lists appropriate for use with the 
different Form Letter templates. The SORT and SELECT 
Stemwriter Utilities are discussed in detail in Lesson 15. 
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14.0 LESSON 14 - SETTING UP A REFERENCE LIST 

You may have several thousand different references, 
spanning many topics and written by many different authors. 
From time to time, you may need to find references on 
certain topics, or by certain Authors, and include them in a 
document under preparation. The Stemwriter package contains 
facilities which permit this to be done efficiently. 

The Stemwriter program allows you to keep track of your 
references with the use of Classified Comment Fields. These 
special purpose Comment Fields contain the classification 
and associated keyword information that act as "handles" to 
allow individual references to be manipulated. 

Your reference list must be created as a segmented 
file, with each individual reference being one file segment. 
The Classified Comment Fields describing the individual 
references must be contained in the first 512 characters of 
the reference. 

Before setting up your reference list, take a little 
time to consider how you will be using your references. 
Having done this, you are then in a position to choose the 
appropriate keyword classes, and keywords by which the 
reference list can be manipulated. The two basic operations 
you can carry out on your Reference list, are: 

(a) Sort the reference list in ascending or descending 
order on a particular keyword, such as Author name. 

(b) Select from the main Reference list, all those 
references meeting certain criteria, and place them in 
a new segmented file. For example, choosing all 
references by a certain author, all references on a 
certain topic, or all references by a certain author on 


a certain 
flexible. 

topic. 

The 

Selection 

process 

is very 

Before you can 

do any 

of 

the above, 

each 

individual 


reference must contain the necessary Class Keys and their 
associated keywords inside Classified Comment Fields. 

An example of a suitably set up reference list is 
contained in the segmented file, /MYTEXT/REFERENCES. Load 
all segments of this file into a clear document of your 
computer's memory in the usual way. Move the cursor through 
the references and observe the manner in which the 
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Classified Comment Fields have been used. 

Notice that each individual reference contains several 
Classified Comment Fields. In this particular reference 
list, authors are classified by the class keys <AUTH0R1>, 
<AUTH0R2>, <AUTHOR3>, and so on, with one such Class key for 
each author. Associated with each Class key is a keyword 
based on the author name, and initials. This keyword must 
be the same for each reference to this author, irrespective 
of whether the Class key signifies first, second, or third 
authorship. Then comes a Classified Comment Field for the 
Year of publication. Finally, there are two or three Class 
Keys <T0PIC1>, <T0PIC2>, <T0PIC3>, each with a keyword which 
describes the substance of the reference. The Topic 
keywords must have been decided upon prior to the setting up 
of the Reference List. You may use as many or as few topic 
keywords as you deem to be necessary. 

For a Reference List keyed as in the example, one can 
select on the basis of Author, and Topic. Some examples of 
possible selection criteria are: 

(1) Papers for which a given Author was sole Author. 

(2) Papers for which a given Author was first Author. 

(3) Papers to which a certain Author contributed. 

(4) Papers to which a certain pair of Authors 
contributed. 

(4) All the above, for a certain year of 

' publication. 

(5) All the above, on a certain topic, or range of 
topics. 

(6) All references on a certain topic, or range of 
topics. 

The above list is by no means exhaustive, but it does give 
you some idea of the flexibility possible, even with the 
fairly simple organization of this example. 

You should now try and create at least one reference 
for yourself using Classified Comment Fields to categorize 
the authors and topic range of the references in a similar 
manner to that which was used to create the file, 
/MYTEXT/REFERENCES. If you like, type in the following 
example reference at the end of the current list of 
references in your computer's memory. 

Move the cursor to the end of the references (press 
Closed Apple 8 and jump to Doc. tail) and press the new 
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paragraph key once. Notice the Para Indent is set to zero. 
The cursor should now be positioned at the left margin, two 
lines below the last reference. Now type the following: 

Taylor, BC, Fitzgibbons, RG, Wright, PW, Anstead, MC: The 
natural habitat of bumble bees. J. Life Sciences 10, 15-19 
( 1967). 

Immediately you have entered this text, begin the first 
Classified Comment Field - Do NOT put in a carriage return 
first! Press Closed Apple 4 and adjust the command line to 
read: 


[Begin] [Comment] Field 

Press RETURN. A right arrow,—», will appear on your screen 
marking the beginning of the Comment Field. The 

classification word or Class Key as we will refer to it, 
must now be entered immediately after opening the Comment 
Field. To do this, type a less than sign, <, followed 
immediately by the Class Key, such as AUTHOR1, followed by 
the greater than sign, >. You must now enter the actual 
name of AUTHORl, immediately after the greater than sign, 
with no spaces. In this case, the name of AUTHORl is 
TAYLORBC. Now close the Classified Comment Field by 
pressing Closed Apple 4 and adjusting the command line to 
read: 

[End] [Comment] Field 

Press RETURN. A left arrow,<—, will appear on your screen, 
immediately following TAYLORBC, denoting the closure of the 
Classified Comment Field. This reference thus far should 
appear as follows: 

Taylor, BC, Fitzgibbons, RG, Wright, PW, Anstead, MC: The 
natural habitat of bumble bees. J. Life Sciences 10, 15-19 
(1967). —»<AUTHORl>TAYLORBC«- 

Notice that there are no spaces between the reference 
proper and the start of the first Classified Comment Field 
and that there are no spaces between or within the various 
parts of the Classified Comment Field. If, for example, 
you put a space in between opening the Comment Field and the 
less than sign, <, the Stemwriter Utilities program will 
treat the Comment Field as an ordinary Comment Field, and 
will ignore it. < AUTHORl> and <AUTH0R1 > are not recognised 
as being the same as <AUTH0R1>. Similarly, < TAYLORBO, 


Lesson 14 




186 


Part 2 - Tutorial 


<TAYLOR BC> and CTAYLORBC > are not the same as CTAYLORBO. 

The case of the letters used in making up the keywords 
matters. For example, <Authorl> and <authorl> are not the 
same as <AUTH0R1>. Similarly, <TaylorBC> is not the same as 
CTAYLORBO. Therefore, make sure that whenever you use a 
certain Class key, or keyword, you do so in exactly the same 
way each time. 

To reduce the chances of the above types of errors 
happening, we recommend you do the following: 

(1) Always capitalise the letters used in Classified 
Comment Fields. 

(2) Never use spaces in Classified Comment Fields unless 
they fall between clearly defined words. 

(3) Place a comment at the head of the reference List to 
remind any user of the above convention. 

(4) When building a Classified Reference list, make use of 
the User Definable Keys to enter the keywords, and 
class keys. This will dramatically reduce the chance 
of typographical errors, and speed up the whole 
process. 

The second Classified Comment Field must be created 
immediately following the first, with no intervening spaces. 
Remember, all text not in Comment Fields is taken as forming 
part of the body of the reference. To add a second 
Classified Comment Field to the example reference you are 
creating, begin the Comment Field as described above, i.e. 
press Closed Apple 4 and adjust the command line to read: 

[Begin] [Comment] Field 


Press RETURN. A right arrow,—>, will appear on your screen 
immediately following the left arrow, <—, which closed the 
first Classified Comment Field. Now enter the second Class 
key for this reference as follows: Type a less than sign, 
C, followed by the word, AUTH0R2, followed by a greater than 
sign, >. Now type the actual name of AUTHOR 2, i. e. 
FITZGIBBONSRG. When you have done this, close the 

Classified Comment Field by pressing Closed Apple 4 and 
adjusting the command line to read: 

[End] [Comment] Field 

Press RETURN. The example reference you are creating should 
now appear as follows: 
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Taylor, BC, Fitzgibbons, RG, Wright, PW, Anstead, MC: The 
natural habitat of bumble bees. J. Life Sciences 10, 15-19 
( 1967). —><AUTHOR1>TAYL0RBC<- -><AUTHOR2>FITZGIBBONSRG<- 

You may associate as many Classified Comment Fields as 
you need with each individual reference, subject to the 
proviso that all must fall within the first 512 characters 
of the reference segment. 

As well as having one Classified Comment Field for each 
author of the reference, you might wish to have several 
more, designating the year of publication, and topics 
covered by the referenced publication. Complete the example 
reference, by adding the remaining two authors, the year of 
publication, and the keywords HABITAT and BUMBLE BEE as 
<TOPICl> and <TOPIC2> respectively. When you have finished, 
your example reference should appear as follows: 

Taylor, BC, Fitzgibbons, RG, Wright, PW, Anstead, MC: The 
natural habitat of bumble bees. J. Life Sciences 10, 15-19 
(1967). —><AUTHOR1>TAYLORBC<- -XAUTHOR2>FITZGIBBONSRG<- 
-><AUTHOR 3>WRIGHTPW4--X AUTHOR4>ANSTEADMC 4- -XTOPICl>HABITAT4- 
-><TOPIC2>BUMBLE BEE<—XYEAR>1967<- 

If your reference appears the same as this, 
congratulations! You should now feel confident to go ahead 
and create your reference list. If not, go back to the 
beginning of this Lesson and have some more practice. 

For advanced users, with a large number of References 
to maintain, it is strongly recommended that you read Lesson 
17.5 - Organizing and Maintaining Segmented Records. 
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15.0 LESSON 15 - USING THE STEMWRITER UTILITIES 

To use the Stemwriter Utilities, insert the Stemwriter 
program diskette into the boot disk drive of your Apple //e 
or //c. Enter the Stemwriter program in the usual way, to 
the point where Stemwriter is expecting text entry. Press 
the CONTROL key at the same time as key B to change from the 
Stemwriter program itself to the Stemwriter Utilities. The 
command line will read as follows: 


Change Interpreters <esc>/Y/N : 

Press Y. Your screen will now read: 

ENTER PREFIX <PRESS "RETURN" TO ACCEPT> 

/STEMWRITER/ 

Press RETURN, as instructed by the message on your screen. 
Your screen will now read: 

ENTER PATHNAME OF NEXT APPLICATION 

You must now type the name of the Utilities Program at the 
current cursor position on your screen, as follows: 

/UTILITY.SYSTEM 

Press RETURN. The Stemwriter Utilities program will now be 
loaded into the computer's memory and the Master Utilities 
Menu will be displayed on your screen as follows: 

Stemwriter Utilities _ Master Level _ Version 1.0 

>: Initialization 
: File Management 
: Sort/Select Segment Records 
: Word/Sentence Count 
: Labels 
: Exit Program 


Press: <arrows> to select <RETURN> to accept 

In contrast to the Stemwriter program itself, the 
Stemwriter Utilities are menu driven and are controlled via 
a series of hierarchial menus. You select the menu option 
you want by using the up/down arrow keys in the usual way, 
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to move the cursor and the greater than sign, >, until it is 
adjacent to that option. To accept this option, press the 
RETURN key once. The current menu level is always displayed 
at tne top of the screen and helpful information is 
displayed at the bottom of the screen. You can ESCAPE, when 
indicated at the bottom of your screen, to a higher level of 
the menu by pressing the ESCAPE key. Each press of the 
ESCAPE key takes you to a higher level of the menu until 
finally you are at the Master Utilities Menu. 

15.1. Sorting Segmented Records 

Two common applications where you need to be able to 
sort segmented files, are for the maintainance of Address 
Lists, and Reference Lists. The following discussion 
contains an example of each application. If one or other of 
these applications is of no interest to you, skip over it. 

The Stemwriter Sort Utility can sort up to a maximum of 
3000 segmented records contained in the one file. For 400 
records or fewer, the sorting process is entirely memory- 
based, but for more than 400 records, a disk scratch area 
must be provided for temporary storage of the Sorting Keys. 
The Sort Utility asks for the name of the disk (Volume) on 
which it can create this scratch area, when it is' required. 
It is suggested that instead of trying to sort 3000 records 
in one large file, you should create your records in files 
whose size can be conveniently fitted into the computer's 
memory (up to 400 records), and to use the file names as a 
broad classification (as described in Lesson 17.5). By this 
means, you can sort ten files, each containing 300 records, 
in much less time than you could sort 3000 records in one 
file. This is because the records are already partially 
pre-sorted, and memory based sorting is a lot faster than 
disk based sorting. 

15.1.1 Sorting An Address List 

The Stemwriter Utilities program should already be 
loaded, with the Master Utilities Menu currently displayed 
on your screen, as shown at the beginning of this lesson. 
To sort your address list into alphabetical order, move the 
cursor using the up/down arrow keys, until it is adjacent to 
the 'Sort/Select Segment Records' option and press RETURN. 
The next level of the menu to be displayed on your screen 
will be as follows: 
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Stemwriter Utilities Sort/Select Segment Records Version 1.0 

> : Sort Segment Records 
: Select Segment Records 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

Using the up/down arrow keys again, move the cursor (if 
necessary) until it is adjacent to the 'Sort Segment 
Records' option and press RETURN. Your screen will now 
read: 


Stemwriter Utilities Sort Segment Records _ Version 1.0 

SORT 

Source File : 

Note: "#" will concatenate keywords 

AKEY#BKEY means append the keyword 
from BKEY to the keyword from AKEY 


Press:<arrows> to select <RETURN> to accept <escape> to exit 


You must now type 

the entire 

pathname 

of the 

file to 

be 

sorted. In this 

case 

the 

example 

address 

file 

is 

/MYTEXT/MAIL.LIST. 

The 

center of your screen will 

now 

appear as follows: 







SORT 







Source File :/MYTEXT/MAIL. 

LIST 






Press RETURN. If you nominated a non-existent file to be 
sorted, the error message 


Message : Source File does not exist 

will appear near the top of your screen. Similarly, if you 
nominated a whole file instead of a segmented file, you will 
get the error message: 

Message : Source File is wrong Type 

If, however, you correctly nominated /MYTEXT/MAIL.LIST, 
as the file to be sorted, the center of your screen will 
appear as follows: 
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SORT 

Source File s /MYTEXT/MAIL.LIST 
Using 

Class Key : 

You must now enter the Class Key on which the addresses 
are to be sorted. To sort the example address file, 
/MYTEXT/MAIL.LIST, on alphabetical order of Surname, you 
would sort the addresses using the Class Key "SURNAME". 
Similarly, to sort this file in order of Zipcode, you would 
use the Class key "ZIP" for the sorting procedure. 

In the first instance, try sorting the file, 
/MYTEXT/MAIL.LIST, into ascending alphabetical order of 
Surname. So, type the Class Key, SURNAME (remember! Case is 
important for Class Keys) onto your screen at the current 
cursor position, to obtain: 

SORT 

Source File :/MYTEXT/MAIL.LIST 
Using 

Class Key :SURNAME 

Press RETURN. The center of your screen will now read: 

SORT 

Source File :/MYTEXT/MAIL.LIST 
Using 

Class Key :SURNAME - In Ascending/Descending 
Order: A/D : 

You may sort the file into ascending alphabetical order from 
A to Z, or into descending order, from Z down to A. To sort 
into ascending alphabetical order, type an A at the current 
cursor position on your screen: 

SORT 

Source File :/MYTEXT/MAIL.LIST 
Using 

Class Key :SURNAME - In Ascending/Descending 
Order: A/D :A 

To begin the sorting procedure, press RETURN. 

Initially, the message : 

Message: Reading the keys . 

will appear near the top of your screen. This message 
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indicates that the Stemwriter Sort Utility is extracting the 
keywords associated with the nominated Class Key, SURNAME, 
to create the Sorting Keys. When this is finished, a new 
message will appear: 

Message: Segments in File = 6 

Sorting the Records . 

This message indicates that the file, /MYTEXT/MAIL.LIST, is 
currently being sorted. When the sorting is complete, the 
following message will appear at the top of your screen: 

Message : Sorting complete with no errors 
Press <SPACE> bar to continue 


On pressing the space bar, you are returned to the Sort 
Source File screen, viz: 


Stemwriter Utilities Sort Segment Records 

Version 1.0 

SORT 


Source File : 


Press:<arrows> to select <RETURN> to accept 

<escape> to exit 


You can now proceed immediately to sort another file or 
to sort the same file on another key or combination of keys, 
if you so wish. 


If you feel as though you would like more practice in 
sorting records in segmented files, try sorting the file, 
/MYTEXT/MAIL.LIST, into ascending order of Zipcode and 
Surname. That is, the zipcodes will be sorted into 
ascending order, and for each zipcode, the names will also 
be in ascending order. This is achieved by appending the 
keywords associated with the Class Key "SURNAME" to the 
keywords associated with the Class Key "ZIP". To do this, 
nominate the Source file as /MYTEXT/MAIL.LIST, and sort this 
file using the Class Key, ZIP#SURNAME. Select 'A' for 
ascending order of sorting. 

If you have finished sorting for the time being, press 
the ESCAPE key once. Your screen will now read: 
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Stemwriter Utilities Sort/Select Segment Records Version 1.0 

> : Sort Segment Records 
: Select Segment Records 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

15.1.2 Sorting A Reference List 

If you have not done so already, load the Stemwriter 
Utilities program as described at the beginning of this 
lesson. When this is done, the Master Utilities Menu will be 
displayed on your screen. To sort your reference list into 
alphabetical order, use the up/down arrow keys in the usual 
way to move the cursor until it is adjacent to the 
'Sort/Select Segment Records' option and then press RETURN. 
The next level of the menu to be displayed on your screen 
will be as follows: 


Stemwriter Utilities Sort/Select Segment Records Version 1.0 

> : Sort Segment Records 
: Select Segment Records 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

Using the up/down arrow keys again, move the cursor until it 
is adjacent to the 'Sort Segment Records' option and press 
RETURN. Your screen will now read: 


Stemwriter Utilities Sort Segment Records Version 1.0 
SORT 

Source File : 

Note: "#" will concatenate keywords 

AKEYiBKEY means append the keyword 
from BKEY to the keyword from AKEY 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

You must now type the full pathname of the file to be 
sorted, which in this case is the example reference file, 
/MYTEXT/REFERENCES. The center of your screen will now 
read: 
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SORT 

Source File :/MYTEXT/MAIL.LIST 

Press RETURN. If you nominated a non-existent file to be 
sorted, the error message 

Message : Source File does not exist 

will appear near the top of your screen. Similarly, if you 
nominated a whole file instead of a segmented file, you will 
get the error message: 

Message : Source File is wrong Type 

If, however, you correctly nominated /MYTEXT/MAIL.LIST, 
as the file to be sorted, the center of your screen will 
appear as follows: 

SORT 

Source File : /MYTEXT/MAIL.LIST 
Using 

Class Key : 

You must now enter the Class Key on which the addresses 
are to be sorted. To sort the example address file, 
/MYTEXT/MAIL.LIST, on alphabetical order of Surname, you 
would sort the addresses using the Class Key "SURNAME". 
Similarly, to sort this file in order of Zipcode, you would 
use the Class key "ZIP" for the sorting procedure. 

In the first instance, try sorting the file, 
/MYTEXT/MAIL.LIST, into ascending alphabetical order of 
Surname. So, type the Class Key, SURNAME (remember! Case is 
important for Class Keys) onto your screen at the current 
cursor position, to obtain: 

SORT 

Source File :/MYTEXT/MAIL.LIST 
Using 

Class Key :SURNAME 


Press RETURN. The center of your screen will now read: 


SORT 


Source File 

:/MYTEXT/MAIL.LIST 

Using 


Class Key 

:SURNAME - In Ascending/Descending 

Order: A/D 

: 
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As this reference file is to be sorted into ascending 
alphabetical order, that is, from A to Z, type an 'A' at the 
current cursor position on your screen, to obtain: 

SORT 

Source File :/MYTEXT/REFERENCES 
Using 

Class Key :AUTH0R1 - In Ascending/Descending 
Order: A/D :A 

To begin the sorting procedure, press RETURN. 

Initially, the message : 

Message: Reading the keys . 

will appear near the top of your screen. This message 
indicates that the Stemwriter Sort Utility is extracting the 
keywords associated with the Class Key, AUTHORl, to create 
the Sorting Keys. When this is complete, a new message will 
appear: 

Message: Segments in File = 6 

Sorting the Records . 

This message indicates that the file, /MYTEXT/REFERENCES, is 
currently being sorted. When the sorting is complete, the 
following message should appear near the top of your screen: 

Message : Sorting complete with no errors 
Press <SPACE> bar to continue 

On pressing the space bar, you are returned to the Sort 
Source File screen, viz: 

Stemwriter Utilities _ Sort Segment Records _ Version 1.0 

SORT 

Source File : 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

You can now proceed immediately to sort another file or 
to sort the same file on another key or combination of keys, 
if you so wish. 

Try sorting the reference list, /MYTEXT/REFERENCES, 
into ascending alphabetical order of first author and 
ascending year of publication. This means that the 
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references for a particular first author will also be sorted 
into ascending order of year of publication. To do this, 
you must sort the references using the combined Class Keys 
'AUTH0R1#YEAR'. This particular combined Class Key tells 
the Stemwriter Sort Utility to append the keyword associated 
with the Class Key 'YEAR' to that associated with the Class 
Key 'AUTH0R1 1 to create the Sorting key. You must also 
select 'A' for ascending order of sorting. 

Similarly, to sort the reference list, /MYTEXT 
/REFERENCES, into ascending alphabetical order of all 
authors as well as ascending year of publication, you must 
sort the references with the combined Class keys 
'AUTHORl#AUTHOR2#AUTHOR3#AUTHOR4#YEAR'. Thus the Stemwriter 
Sort Utility will append the keywords associated with the 
Class Keys •AUTHOR2', 1 AUTHOR3', 1 AUTH0R4' and 'YEAR' to 
that associated with the Class Key 'AUTH0R1', to create the 
Sorting key. The Sorting key truncates at a maximum of 40 
characters. 

When you have finished sorting the reference files, 
press ESCAPE and your screen will display the 'Sort/Select 
Segment Records' menu, as follows: 

Stemwriter Utilities Sort/Select Segment Records Version 1.0 

: Sort Segment Records 
: Select Segment Records 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

15.2 Selection Of Records From A Segmented File 

The 'Select' option of the Stemwriter Utilities program 
enables you to select particular records from a segmented 
file according to defined criteria. For example, you may 
select all records from an address file with a particular 
zipcode or surname. You may select all references from your 
master reference file for a particular author or relevant to 
a certain topic. You may select all standard paragraphs 
from your file of standard paragraphs which ■ relate to a 
particular topic such as air conditioning, bridge 
construction, franchising, computer software, sewerage 
systems, taxation, etc. 

If you are continuing on from Lesson 15.1, the 
'Sort/Select Segment Records' menu should already be 
displayed on your screen. If not, load the Stemwriter 
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Utilities program as described at the beginning of Lesson 
15, and display the Master Utilities Menu. To select the 
required records from your segmented file, move the cursor 
in the usual way, until it is adjacent to the 'Sort/Select 
Segment Records' option and then press RETURN. Your screen 
will now appear as follows: 

Stemwriter Utilities Sort/Select Segment Records Version 1.0 

> : Sort Segment Records 
: Select Segment Records 


Press:<arrows> to select <RETURN> to accept <escape> to exit 


Move the cursor until it is adjacent to the 'Select Segment 
Records' option and press RETURN. Your screen will now 
read: 

Stemwriter Utilities Select Segment Records Version 1.0 

Class Key(s) : 

Note means "AND" 

"+" means "OR" 
means "NOT" 

A.B+C. D means ("A" AND "B") OR ("C" AND NOT "D") 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

15.2.1 Selection Prom An Address List 

To select records from the address file, /MYTEXT/MAIL. 
LIST, with the zipcode number 12xxx (where xxx means any 
legal digit), enter the Class Key "ZIP" as follows: 

Class Key(s) :ZIP 

Press RETURN to accept the Class Key, ZIP, for the selection 
process. The center of your screen will now read: 

For Class Key(s) :ZIP 
Enter 

Keyword : 

To select all records from your address file whose zipcodes 
begin with the digits '12', you must enter the keyword, 12" 
(where * is the wildcard designator, which means that all 
addresses whose zipcodes begin with the digits 12 will be 
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selected), at the current cursor position so that you have: 

For Class Key(s) :ZIP 
Enter 

Keyword :12* 

When you are satisfied that the Select keyword you want is 
displayed on your screen, press RETURN. You are now asked 
for the pathname of the file from which the addresses are to 
be selected: 

Source File : 

Type the required pathname, as follows: 

Source File :/MYTEXT/MAIL.LIST 

Press RETURN. The selection process will now begin and the 
following message will appear near the top of your screen: 

Message : Match on ZIP 12' 

You must now type the pathname of the file which is to 
receive the selected address records, as follows: 

Message : Match on ZIP 12' 

Source File :/MYTEXT/MAIL.LIST 
Destn File :/MYTEXT/ZIP12 

Press RETURN. The selection process will now continue and 
when complete the following message will appear on your 
screen: 

Message : Selection Complete with no errors 

There were 2 matches from 6 segments 
Press <SPACE> bar to continue 

If there had been no matches for the selection process, the 

message 

Message : Selection Complete with no errors 
No Matches were found 
Press <SPACE> bar to continue 

would have appeared on your screen. 

On pressing the space bar, you are returned to the first 
level of the 'Select Segment Records' Utility as follows: 


Lesson 15 







Part 2 - Tutorial 


199 


Stemwriter Utilities Select Segment Records Version 1.0 

Class Key(s) : 

Note means "AND" 

"+" means "OR" 
means "NOT" 

A.B+C._D means ("A" AND "B") OR ("C" AND NOT "D") 

Press:<arrows> to select <RETURN> to accept <escape> to exit 

Suppose you want to select those addresses whose 
zipcodes do not begin with the digits 12, or 45. That is, 
two regional groupings for the addresses are to be rejected. 
The Class Keys for the Selection process become: 

Class Key(s) :_ZIP._ZIP 

which means 'Not the first zipcode and not the second 
zipcode either'. For the first Class Key, the associated 
keyword is: 

For Class Key(s) :ZIP 
Enter 

Keyword :12“ 

and for the second Class Key the associated keyword is: 

For Class Key(s) :ZIP 
Enter 

Keyword :45~ 

The remainder of this selection exercise will proceed as 
described above for the first selection exercise. 

Further, if you want to select those addresses whose 
zipcodes start with either the digits 12, or the digits 45, 
you must specify the Class Key selection expression as 
follows: 

Class Key(s) :ZIP+ZIP 

The associated keywords for this selection are as for the 
immediately preceding example. 
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15.2.2 Selecting From A Reference List 

To select particular references from your reference 
list, /MYTEXT/REFERENCES, which relate to the topic. Bumble 
Bee, type the Class Key 1 TOPIC* 1 (where " is the wildcard 
designator, which means that all topics will be scanned 
looking for the keyword, BUMBLE BEE) at the current cursor 
position on your screen as follows: 

Class Key(s) :TOPIC" 


Press RETURN to accept the Class Key, TOPIC", for the 
selection process. The center of your screen will now read: 

For Class Key(s) .-TOPIC" 

Enter 

Keyword : 

To select all references relevant to the topic. Bumble bees, 
you must enter the keyword, BUMBLE BEE, at the current 
cursor position, as follows: 

For Class Key(s) :TOPIC" 

Enter Keyword :BUMBLE BEE 

When you are satisfied that the Select keyword is displayed 
exactly as it occurs in your reference file, press RETURN. 
You must now type the whole pathname of the file from which 
the references are to be selected, as follows: 

Source File :/MYTEXT/REFERENCES 

Press RETURN. The selection process will now begin and the 
message 

Message : Match on TOPIC" BUMBLE BEE 

will appear near the top of your screen. You must now type 
the pathname of the file which is to receive the selected 
references, as follows: 

Message : Match on TOPIC" BUMBLE BEE 

Source File :/MYTEXT/REFERENCES 
DeStn File :/MYTEXT/REFER.BUMBLEB 

Press RETURN. The selection process will now continue and 
when complete, the following message will appear on your 
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screens 


Message : Selection Complete with no errors 

There were 8 matches from 8 segments 
Press <SPACE> bar to continue 

If there had been no matches for the selection process, 
the following message would have appeared on your screen: 

Message s Selection Complete with no errors 
No Matches were found 
Press <SPACE> bar to continue 

On pressing the space bar, you are returned to the 
first level of the 'Select Segment Records' Utility as 
follows: 


Stemwriter Utilities Select Segment Records Version 1.0 
Class Key(s) : 


Note : means "AND" 

"+" means "OR" 
means "NOT" 

A.B+C. D means ("A" AND "B") OR <"C" AND NOT "D") 


Press;<arrows> to select <RETURN> to accept <escape> to exit 

Suppose you wish to select all references which are 
relevant to the combined topic. Bumble bees and economics 
(which means that all references will be scanned looking for 
the occurrence of both keywords). To do this, you must 
enter the Class Key expression as 'TOPIC*.TOPIC*' on your 
screen as follows: 


Class Key(s) :TOPIC*.TOPIC* 



Press RETURN to accept 

this Class 

Key 

expression for the 

selection process. Your 

screen will 

now 

read: 

For Class Key(s) :TOPIC* 
Enter 

Keyword : 




To select all references 

which have 

the 

two topic keywords. 


'BUMBLE BEE' and 'ECONOMICS', you must type them both on 
your screen when asked. For the first Class Key, type the 
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first keyword, as follows: 


For Class Key(s) 
Enter 

Keyword 

:TOPIC' 

:BUMBLE BEE 

Press RETURN, 
keyword: 

For the second Class Key, type the second 

For Class Key(s) 
Enter 

:TOPIC' 

Keyword 

:ECONOMICS 

Press RETURN. 



The remainder of this selection exercise should now 
proceed as described above for the simple selection 
exercise. For this exercise, the Stemwriter Select Utility 
will only select those references which contain both 
keywords, i.e. ’BUMBLE BEE’ and 'ECONOMICS'. 

Suppose you want to find all references written by the 
author, ROBERTSON, TB on the topic of Orchard Economics. If 
you search through your reference list on author and on the 
topics. Orchard and Economics, you will find all relevant 
publications by'Robertson, T.B. As you will be selecting on 
one Author and on two topics, you must type the Class Key(s) 
expression on your screen, as follows: 

Class Key(s) :AUTHOR'.TOPIC'.TOPIC' 

Press RETURN to accept the expression, 'AUTHOR'.TOPIC'. 
TOPIC'’, for the selection process. You must now enter the 
relevant keywords sequentially onto your screen as they are 
requested, as follows: 

For Class Key(s) :AUTHOR' 

Enter 

Keyword :ROBERTSONTB 

Press RETURN. For the second Class Key, enter the second 
keyword: 

For Class Key(s) :TOPIC' 

Enter 

Keyword :ORCHARD 

Press RETURN. For the third Class Key, enter the third 
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keyword: 

For Class Key(s) :TOPIC' 

Enter 

Keyword :ECONOMICS 

Press RETURN. Continue this selection exercise as described 
for the first selection example. The Stemwriter Selection 
Utility will only select those references which have 
ROBERTSON, TB, as one of the authors and which contain both 
the nominated keywords, i.e. ORCHARD and ECONOMICS. 

More complex selection procedures than those above may 
be used, with an upper limit of 8 Class keys in the 
Selection expression. The order of inqplementation of the 
logical operators is 'NOT', 'AND', 'OR', in that order. 

15.2.2.1 Fast Printing Of A Reference List 

If you want to obtain a quick print-out of references 
selected from a reference file, you can print the selected 
references using the 'Labels' option of the Utilities 
program. 

Return to the Utilities Master Level by pressing the 
ESCAPE key until it appears on your screen. Using the 
up/down arrow keys in the usual way, move the cursor until 
it is adjacent to the 'Labels' option of the Utilities 
program and press RETURN. Your screen will now appear as 
follows: 


Stemwriter Utilities_Labels_Version 1.0 


Lines per Label (1-99) : 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

You will be asked successively to enter the following 
parameters for label printing (for more details see Lesson 
15.3). The following values should be satisfactory in most 
cases: 


Lines per Label (1-99) 
Lines between Labels (1-99) 
Labels across Page (1-99) 
Label width in Chars (1-99) 
Chars in Left Margin (0-99) 
Chars between Labels (1-99) 


: 5 
: 1 
: 1 
: 80 
: 10 
: 1 
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When the above information has been supplied, you are asked 
whether the labels are to be printed immediately or spooled 

to a file. To print, type P, as follows: 

Send to Printer/File (P/F) :P 

Press RETURN. You are now asked the following question: 
Printer needs LF after CR (Y/N) : 

If you have been using Stemwriter to print a document 
immediately beforehand, then for some printers, the line 
spacing will have been set to permit the production of super 
and subscripting. If you suspect that your printer works 
this way, then initialize it before proceeding further. If 
in doubt as to how to do this, turn your printer 'off', and 
then 'on' again. 

If unsure as to whether your printer requires a Line 
Feed character following a Carriage Return character, 
conduct the following experiment. Answer the question with 
a 'Y'. If the subsequent print-out is double line spaced, 
the answer should have been 'N', as your printer does not 
need the Line Feed Character after a Carriage Return. 
Remember the result of this experiment for the next time you 
need to use this facility. 

You must now nominate the name of the reference file 
you wish to print. For example, to print the file, 
/MYTEXT/REFERENCES, ensure that your printer is turned on 
and then type: 

Source File :/MYTEXT/REFERENCES 

Press RETURN. The segmented file, /MYTEXT/REFERENCES, will 

now be printed and none of the Comment Fields will be 
printed. When the printing is complete, your screen will 
show the message: 

Message : Task complete with no Error 

Press <SPACE> bar to continue 

On pressing the space bar, you are returned to the 
first screen of the 'Labels' Utility of the Stemwriter 

program. 
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If you mistakenly nominate a non-existent file for 
printing, you will get the error message: 

Message : Source File does not exist 

If you mistakenly nominate a whole file instead of a 
segmented file for printing, you will get the error message: 

Message : Source File is wrong type 

If the printer was not turned on, you will lock up your 
system and the following error message will appear on your 
screen: 


Message : File System Error 

If you get this message, you will have to re-boot your Apple 
//e or //c. 

You can ESCAPE to the previous level of the Labels menu 
by pressing the ESCAPE key once. Each time you press the 
ESCAPE key, you are moved to the next highest level of the 
Utilities menu until eventually you are returned to the 
Master Utilities Menu. 

15.2.3 Selecting Standard Paragraphs 

If your particular application requires that you be 
able to rapidly create new documents from various standard 
paragraphs, e.g. for creating tenders, quotes, legal 
contracts, specifications of various types, the best thing 
to do is to create a segmented file of standard paragraphs. 
Further, if you associate with each standard paragraph, one 
or more Topic keys, you may then select the desired standard 
paragraphs on the basis of either topic or numerical 
position in the segmented file. When all desired paragraphs 
are selected, you can alter their order using the BLOCK MOVE 
command, and then make any minor alterations to customise 
your document secure in the knowledge that the master copy 
of your standard paragraphs remains untouched. 

An example segmented file containing a series of 
standard paragraphs is contained on your user diskette, 
/MYTEXT. This file contains 12 individual segments, each of 
which is one standard paragraph. Each paragraph has several 
appropriate Classified Comment Fields associated with it. 
Each Classified Comment Field contains a topic keyword 
relevant to the information within the standard paragraph. 


Lesson 15 



206 


Part 2 - Tutorial 


Try selecting all paragraphs from the file, 
/MYTEXT/ARTICLES, which are relevant to the topic. Finance. 
If you are continuing on from Lessons 15.2.1, or 15.2.2, the 
Stemwriter Utilities program will already be loaded. Press 
the ESCAPE key until the Utilities Master Level is displayed 
on your screen. Otherwise, load the Stemwriter Utilities 
program to display the Master Utilities Menu on your screen, 
as follows: 


Stemwriter Utilities Master Level Version 1.0 

> 

Initialization 

File Management 

Sort/Select Segment Records 

Word/Sentence Count 

Labels 

Exit Program 

Press: <arrows> to 

select <RETURN> to accept 


As you wish to 'Select' records from a file, use the 
up/down arrow keys to move the cursor until it is adjacent 
to the 'Sort/Select Segment Records' option. Press RETURN 
and the center of your screen will now read: 

> : Sort Segment Records 
: Select Segment Records 


Using the up/down arrow keys again, move the cursor until it 
is adjacent to the 'Select Segment Records' option and press 
RETURN. The screen will read: 


Stemwriter Utilities 

Select 

Segment 

Records Version 

1.0 

Class 

Key(s) : 







Note: 

means "AND" 
"+" means "OR" 
means "NOT" 
A. B+C._D means 

("A" 

AND 

" B ”) 

OR 

("C" AND NOT "D") 


Press 

:<arrows> to select 

<RETURN> 

to 

accept <escape> to 

exit 


The Stemwriter Utilities program is now waiting for you 
to enter the Class Key(s) (in the form of an expression) to 
be used in the selection process. To select all paragraphs 
from your standard paragraph file which are relevant to the 
topic. Finance, type, TOPIC”, as the Class Key on your 
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screen: 


Class Key(s) :TOPIC" 

The Class Key, TOPIC", tells the Stemwriter Utility program 
to scan all topic keywords in every file segment during the 
Selection process. The " character is a wildcard, or "don't 
care" indicator, and ensures that every topic Class Key (viz 
TOPICl, TOPIC2, TOPIC3 etc) will be scanned for a matching 
keyword. 

Press RETURN. The Stemwriter Utilities program will now ask 
you to type in the associated keyword, as follows: 

For Class Key(s) :TOPIC" 

Enter 

Keyword : 

To select all paragraphs from your standard paragraph file 
relating to the topic. Finance, type the keyword, FINANCE, 
at the current cursor position: 

For Class Key(s) :TOPIC" 

Enter 

Keyword :FINANCE 

Press RETURN. The Stemwriter Select Utility now asks you to 
type the pathname of the file from which the selection of 
standard paragraphs is to be made. You must type the whole 
pathname of the file as follows: 

Source File :/MYTEXT/ARTICLES 

Press RETURN. Each segment is now scanned to see if it 
contains the specified Class Key and the associated keyword. 
When a match is found, the message: 

Message : Match on TOPIC" FINANCE 

is displayed. The Select Utility now asks for the pathname 
of the destination file to which the selected paragraphs are 
to be written: 


Source File :/MYTEXT/ARTICLES 
Destn File : 

Type the pathname of the destination file, as follows: 
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Destn File :/MYTEXT/SELECT1 

Press RETURN. The selection process continues and each 
selected paragraph is indicated as it is copied to the 
destination file. When the selection process is complete, 
the following message is displayed: 

Message : Selection Complete with no errors 

There were 4 matches from 12 segments 
Press <SPACE> bar to continue 


On pressing the space bar, you are returned to the first 
level of the 'Select Segment Records' Utility as follows: 


Stemwriter Utilities 

Select Seqment Records Version 

1.0 

Class Key(s) : 



Note: ". M means "AND" 
"+" means "OR" 
means "NOT" 
A.B+C._D means 

("A" AND "B") OR ("C" AND NOT "D" 


Press: <arrows> to select <RETURN> to accept <escape> to 

exit 


The Select Utility is waiting for you to carry out 
another Selection procedure. If you would like more 
practice, try selecting all paragraphs relating to the 
topic, MANUFACTURE, from the file, /MYTEXT/ARTICLES. 

If there had been no matches in the selection process, 
you would not have been asked for a destination file, and 
the message 


Message : Selection Complete with no errors 
No Matches were found 
Press <SPACE> bar to continue 

would have appeared on the screen. To return to the Master 
Utilities Menu, press ESCAPE until it appears on your 
screen. 

15.3 Label Printing 

The Stemwriter Utilities disk contains a Utility which 
will allow you to print mailing labels for the addresses in 
an address file. Each address is taken as being all the 
text in a particular segment that is not contained in 
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Comment Fields. 

Preparation : Before selecting the Label printing Utility, 

some initial preparation is required. Take out your label 
sheet and an inch ruler, and carefully measure the following 
dimensions: 

: The vertical space between labels. 

: The depth of a label. 

: The width of a label. 

: The horizontal space between labels. 

: The number of labels across the sheet. 

As the Label printing Utility measures position across the 
sheet in character spaces, and depth on the sheet by number 
of lines, the measurements you have just made must be 
converted into character spaces for: 

: Label width 

: Horizontal space between labels 
and whole single-spaced lines for: 

: Lines in a label (label depth) 

: Lines between labels (vertical space between labels) 

Typical values are 12 characters per inch for character 
pitch, and 6 lines per inch for line spacing. If you are 
going to print the labels directly, then before proceeding 
further, check that your printer is turned on, and if 
necessary, confirm that the line spacing and character size 
settings match those you have nominated to use. Load the 
label sheets into the printer, and check that the printer 
carriage is correctly positioned at the upper left hand 
corner of the first label to be printed. You are now ready 
to print some address labels. 

To print a series of mailing labels with names and 
addresses from an address file, you must load the Stemwriter 
Utilities program. Do it now, if you have not done so 
already. 

The first thing to appear on your computer's screen is 
the Master Utilities Menu, as follows: 
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Stemwriter Utilities_Master Level_Version 1.0 


Initialization 
File Management 
Sort/Select Segment Records 
Word/Sentence Count 
Labels 

Exit Program 


Press: <arrows> to select <RETURN> to accept 

Using the up/down arrow keys, move the cursor until it 
is adjacent to the 'Labels' option of the menu and press 
RETURN. Your screen will now appear as follows: 

Stemwriter Utilities _ Labels _ Version 1.0 

Lines per Label (1-99) : 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

The Label Printing Utility is now waiting for you to 
tell it the number of single-spaced lines that each label 
occupies. If your printer prints at 6 lines per inch and 
each label is 1 inch deep, type 6 at the current cursor 
position on your screen and press RETURN to accept this 
value. The center of your screen will now read: 

Lines between Labels (1-99) : 

You must now enter the vertical distance between labels, to 
the nearest whole number of single-spaced lines, e.g. type 2 
and press RETURN. Your screen will now read: 

Labels across Page (1-99) : 


You must now enter the number of address labels to be 
printed across the page, e.g. 3. Press RETURN. Your screen 
will now read: 

Label width in Chars (1-99) : 


You must now tell the Stemwriter program the width of each 
address label in characters. For example, if each label is 
2.5 inches wide and you are printing at 12 characters per 
inch, then the label width in characters, is 30. Type 30 at 
the current cursor position and press RETURN. Your screen 
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will now reads 


Chars in Left Margin (0-99) s 


You must now nominate the number of spaces to be allotted to 
the left margin of each label, e.g. 5, at the current cursor 
position. Press RETURN and your screen will read: 

Chars between Labels (1-99) : 

You must now nominate the amount of space (in characters) 
between labels across the page. For example, if you are 
printing at 12 characters per inch and there is a quarter of 
an inch between labels, this is equivalent to 3 characters. 
Type 3 at the current cursor position and then press RETURN. 
Your screen will now appear as follows; 

Send to Printer/File (P/F) ; 

To print the labels immediately, type P for printer at the 
current cursor position. If, however, you would like to 
create a file of addresses, formatted ready for printing on 
your adhesive label sheets, type F for file at the current 
cursor position. The formatted address file may then be 
printed as a background task from the Stemwriter program, 
rather than from the Utilities program. This also allows 
you to print the same labels over and over again, without 
having to re-format them every time. 

For the case where you print the address labels 
directly, your screen will read: 

Send to Printer/File (P/F) :P 


Press RETURN. The center of your screen will now read: 

Printer needs LF after CR (Y/N) : 


If you are using the parallel printer driver correctly 
configured, the answer to this question will always be 'N'. 
If, however, you are using the serial printer driver, you 
must determine whether your printer requires the control 
codes Carriage Return followed by Line Feed to select a new 
line, or whether Carriage Return by itself will suffice, and 
then answer accordingly. When this information is correctly 
entered, your screen will read: 

Source File: 
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You must now type the pathname of the address file from 
which the addresses are to be drawn, e.g. /MYTEXT/MAIL.LIST. 
Your screen should now be similar to the following: 

Stemwriter Utilities_Labels_Version 1.0 


Source File :/MYTEXT/MAIL.LIST 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

Press RETURN. The printer will now begin printing the 
address labels. When printing is complete, your screen will 
display the message: 

Message : Task complete with no Errors 
Press <SPACE> bar to continue 

When you press the space bar, you are returned to the first 
screen of the Label printing Utility as follows: 

Stemwriter Utilities _ Labels _ Version 1.0 

Lines per Label (1-99) : 

Press:<arrows> to select <RETURN> to accept <escape> to exit 

You may now format/print another address file, if you so 
wish. Otherwise, return to the Master Utilities Menu by 
pressing ESCAPE. 

For the case where you wish to create a file of 
addresses, formatted ready for printing on labels, type 'F' 
on your screen, as follows: 

Send to Printer/File (P/F) :F 

Press RETURN. As for printing labels immediately, you are 
now asked for the name of the address file, and you should 
respond by typing: 

Source File :/MYTEXT/MAIL.LIST 

or something similar. Press RETURN. You must now nominate 
the name of the whole file to which the formatted addresses 
are to be saved. For example, try saving to the file, 
/MYTEXT/LABEL.DEMO. Your screen will now appear as follows: 
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Source File :/MYTEXT/MAIL.LIST 
Destn File :/MYTEXT/LABEL.DEMO 

Press RETURN. The Stemwriter Label Utility program will now 
format the address file, /MYTEXT/MAIL.LIST, and write the 
formatted address list to the file, /MYTEXT/LABEL.DEMO. 
When the task is complete, the following message will be 
displayed: 

Message : Task complete with no Errors 
Press <SPACE> bar to continue 

On pressing the space bar, you are returned to the 
first 'Labels Utility' screen as follows: 

Stemwriter Utilities_Labels_Version 1.0 


Lines per Label (1-99) : 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

You may now generate address labels from other address 
files, if you so wish. To return to the Master Utilities 
menu, press ESCAPE. 

If you wish to escape from the Label generating process 
at any stage, simply press ESCAPE, and you will be returned 
to the Main Menu. 

15.3.1 Error Conditions 

If you nominate a non-existent file as the Source File 
for the Labels Utility, the error message 

Message : Source File does not exist 

will appear on your screen. You may now enter the name of 
an existing segmented file. 

If you nominate a whole file instead of a segmented 
file as the Source File for the 'Labels' Utility, the error 
message 


Message : Source File is wrong type 

will appear on your screen. You must now enter the name of 
an existing segmented file. 
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If you send the Labels to the printer without switching 
it on, you will cause your computer system to 'hang up', and 
the following error message will appear on your screen: 

Message : File System Error 

To recover, you will have to re-load the Stemwriter 
Utilities program. 
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16.0 LESSON 16 - USING THE STEMWRITER UTILITIES (Continued) 

In Lesson 15, we examined Utilities for SORT/SELECTION, 
and LABEL printing. In this lesson, we will examine the 
remaining Utilities. 

To commence, put the Stemwriter // program diskette 
into the boot drive of your Apple //e or //c and load the 
Stemwriter // Utilities program, as described at the 
beginning of Lesson 15. When this is complete, your screen 
will display the Stemwriter Utilities Master Level Menu, as 


follows: 

Stemwriter Utilities Master Level Version 1.0 

> 

Initialization 

File Management 

Sort/Select Segment Records 

Word/Sentence Count 

Labels 

Exit Program 

Press: <arrows> 

to select <ENTER> to accept 


16.1 Changing The Printer 


When the Stemwriter program is booted, one of its first 
acts is to read the contents of a file called STEM.CONFIG on 
the program diskette. This file contains tables of valuable 
information which are used to set the way that Stemwriter is 
to work. By editing the contents of these tables, we can 
change many of the features of Stemwriter to suit our 
preferences. A substantial portion of these tables is 
devoted to configuring Stemwriter to work with your printer. 
If you are fortunate, Stemwriter will come ready to work 
with your printer. In this case, you may skip to Lesson 
16.2. 


To understand how characters are printed by Stemwriter, 
consider the following sequence of events. Stemwriter sends 
characters, and standardised print formatting directives to 
its built-in Abstract Printer. The Abstract Printer then 
converts these requests into character and command codes 
which are intelligible to the printer. These are then 
passed on to the printer driver for transmission to the 
printer. In turn, the printer driver operates on the 
hardware or firmware of the printer controller card to 
achieve this purpose. Thus, in configuring Stemwriter for a 
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particular printer, there are two distinct tasks to be 
performed, viz: 

(1) One must tell the Stemwriter Abstract Printer, how to 
'speak' to the physical printer controller card. This 
is done by selecting the appropriate printer driver, 
configuring it correctly, and then making it available 
to Stemwriter. 

(2) The Abstract printer component of Stemwriter must be 
informed of the properties of the printer, and the 
command sequences necessary to elicit the desired 
response from the printer. This is done by editing the 
configuration file, STEM.CONFIG, on the Stemwriter 
program diskette. 

Given that you need to change the initial configuration 
of Stemwriter, select the 'Initialization' option on the 
Master Menu of the Stemwriter Utilities program. When this 
option is selected, you are presented with the further 


choices: 


Stemwriter // Utilities Initialization 

Version 1.0 

> : Select Printer Driver 
: Configuration Tables 


Press:<arrows> to select <RETURN> to accept 

<escape> to exit 


Both these options will need to be exercised in setting up 
Stemwriter to work with a different printer. For complete 
details on how these options are used, refer to Part 4, the 
Utilities, Chapters 1 and 2. Here, we will confine 
ourselves to the major steps involved in setting up for a 
different printer. 

16.1.1 Selecting the Printer Driver 

The sub-directory DRIVERS on the Stemwriter program 
diskette contains the following drivers: 

Name Description 

SERIAL.DRIVER For Apple Super Serial Card 

GENERIC.DRIVER For Cards using Pascal 1.1 protocol 

PARALLEL.DRIVER For Apple Parallel Interface Card 

If your computer is an Apple //c, you must use the driver 
SERIAL.DRIVER. If your computer is an Apple //e, choose the 
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driver most compatible with your printer controller card. 
Assuming that the Stemwriter Utilities have been activated, 
and you have already chosen the Initialization option from 
the Master menu, select the option 'Select Printer Driver' 
in the usual way. You will be asked the question: 

Install Driver : 


Give the full pathname to the required driver, as follows: 

Install Driver :/STEMWRITER/DRIVERS/SERIAL.DRIVER 

The serial driver will be copied to the volume directory 
/STEMWRITER, and renamed to STEM.DRIVER. This is the driver 
which will be used the next time Stemwriter attempts to 
print a document. 

After having installed your driver, the task is not yet 
complete. It is still necessary to tell the driver how to 
'talk' to the printer. In computerese, this is called 

'selecting the communications protocol'. This task is done 
by editing the Printer Attributes Table, contained in the 
Stemwriter Configuration Table, STEM.CONFIG. We will 
discuss how to do this in the very next section. 

16.1.2 Configuring the Printer 

If you are using a printer other than the pre¬ 

configured one, or you need initial settings which differ 
from those provided, you must edit the Stemwriter 

Configuration Table. This table is stored as the file STEM. 
CONFIG, and is read by Stemwriter when the program is 

booted. Amongst other things, the Configuration Tables 
provide for: 

* Initialization of User Definable Keys 

* Printer Attributes 

* Printer Code Conversion Tables 

* Standard paper sizes 

* Overlay Prefix 

* Auxiliary Character Shapes 

For convenience, the Stemwriter program diskette contains 
several pre-configured copies of the file STEM.CONFIG, 
suitable for use with a range of printers. These tables are 
to be found in the sub-directory CONFIG.TABLE, on the 
Stemwriter program diskette. The printers represented will 
change from time to time, so refer to the included 
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supplementary information leaflets for details relevant to 
your copy of Stemwriter. 

Suppose, for argument's sake, you are using a Toshiba 
P1350 printer, with a serial interface. Then, assuming that 
you have already selected the Serial driver, as detailed in 
Lesson 16.1.1, proceed as follows: 

Return to the 'Initialization' Menu level of the 
Stemwriter Utilities program, viz; 

: Select Printer Driver 
: Configuration Tables 

Choose the Configuration Tables option. The center of your 
screen should then appear as follows: 

Edit Utilities Table : 

Save Table as File : 

Error : 

> : Edit User Definable Keys 
: Edit Printer Attributes 
: Overlay Prefix 
: Edit Paper Sizes 
: Edit Character Code & Size 
: Edit Printer Control Table 
: Save Edited Parameters 

At the current cursor position, type in the pathname to the 
Configuration Table required. In our example, we are going 
to use a Toshiba P1350 printer: 

Edit Utilities Table :/STEMWRITER/CONFIG.TABLE/TOSHIBA.Pi350 

The pre-configured table will then be copied to memory, and 
made available for editing. The cursor should now be 
positioned adjacent to the list of tables available for 
editing. Move the cursor adjacent to the 'Priater 

Attributes' option, and press RETURN. Your screen should 
appear as follows: 


| 00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

0A 

OB 

QC 

0D 0E OF 

00 I [10] 

08 

01 

07 

80 

13 

11 

50 

23 

80 

04 

05 

06 

80 


The byte currently being edited is shown in the square 
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brackets. To move the square brackets, use the right and 
left arrow keys. To alter the value of the byte within the 
square brackets, type in the new value, and press RETURN to 
accept it. Bytes 0 to 7 contain information needed to 
initialize the printer controller card, and bytes 08 to OD 
contain information on how the printer works. Here, we will 
just concern ourselves with bytes 0 to 7. For full details 
on bytes 08 to OD, refer to Part 4, the Utilities, Chapter 
2.2.2, of this manual. For the three supplied drivers, the 
significance of bytes 0 to 7 is as shown in Figure 16.1. 

The printer controller card is usually placed in Slot 1 of 
the Apple //e, and is always Slot 1 for the Apple //c. 
Thus, the usual entry for this byte is 10. If you are not 
using the Serial Driver, play safe by setting bytes 1 and 2 
to zero. For the Serial Driver, check the switch settings 
on your printer's communications interface, and adjust the 
table entries to suit. 

When you have set the values of Bytes 0 to 7, press 
ESCAPE to return to the Configuration Table menu. Adjust 
any other settings that you wish, using information from the 
Utilities Section of this manual. When you are satisfied, 
select the 'Save Edited Parameters' option. The cursor will 
move to the top of the screen, and suggest: 


Save Table as File :/STEMWRITER/CONFIG.TABLE/TOSHIBA.P1350 

Using the left arrow, remove the pathname, leaving only the 
portion /STEMWRITER/. Type STEM.CONFIG, to obtain: 


Save Table as File :/STEMWRITER/STEM.CONFIG 
Press RETURN, and you will be asked: 

Overwrite Existing Table? Y/N : 

Type "Y", and the new Table values will be entered in the 
file STEM.CONFIG on the Stemwriter program diskette. 

16.2 The File Utilities 


A selection of file management Utilities are provided 
when the 'File Management' option is selected from the 
Master Menu. When this selection is made, the screen looks 
as follows: 
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Byte 

0 : 

1 : 


2 : 

3 : 

4 : 

5 : 

6 : 

7 : 

Figure 


Significance to Driver 


Parallel 

Generic 

Serial 

Slot x 16 

Slot x 16 

Slot x 16 

EOR Mask 

- 

3 

110 Baud 



6 

300 Baud 



7 

600 Baud 



8 

1200 Baud 



9 

1800 Baud 



0A 

2400 Baud 



OB 

3600 Baud 



OC 

4800 Baud 



0D 

7200 Baud 



0E 

9600 Baud 

AND Mask 

- 

0 

8 bits, 1 Stop 



1 

7 bits, 1 Stop 



4 

8 bits, 2 Stop 



5 

7 bits, 2 Stop 

- 

- 

0 

No Parity 



1 

Odd Parity 



3 

Even Parity 



5 

Mark Parity 



7 

Space Parity 

- 

- 

00 

No Handshake 



01 

ENQ/ACK 



40 

H'ware Handshake 



80 

XON/XOFF 

- 

- 

13 

(XON) 



05 

(ENQ) 



03 

(ETX) 

- 

- 

11 

(XOFF) 



06 

(ACK) 

- 

- 

Block Size (ENQ/ETX) 

16.1 Printer 

Configuration 

Bytes 
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Stemwriter Utilities File Utilities 

Version 1.0 

> : Create Vanilla File 


: Copy Segmented File 
: Combine Segmented Files 
: Format a Volume 


Press:<arrows> to select <RETURN> to accept 

<escape> to exit 


To select an option, use the up/down arrows to position the 
cursor adjacent to the desired option, and press RETURN. 


16.2.1 Formatting A Diskette 

The process of formatting (initializing) diskettes 
involves the writing of special identification information 
(rather like street sign-posts) onto the diskettes. The 
process of formatting the storage medium of a diskette is 
not to be confused with the process of formatting a text 
file for printing, although they both involve the 
organization of data according to a pre-determined set of 
rules. 

Before you can format (initialize) diskettes, ensure 
the Stemwriter // Utilities program is loaded into your 
computer's memory. 

To format (initialize) a diskette, select the 'Format a 
Volume' option from the File Utilities Menu in the usual 
way. Your screen will now read: 

Stemwriter Utilities Formatting a Volume _ Version 1.0 

Format Medium in Slot :6 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

'Slot' refers to the slot in your Apple in which the Disk 
controller card is installed. For the Apple //e, this is 
usually Slot 6, and for the Apple //c, it is always Slot 6. 
The disk controller card can support two drives, designated 
as drives 1 and 2. The 'boot' drive will almost always be 
referenced as Slot 6, Drive 1. These are the numbers 
suggested by the disk formatting utility. The second drive 
would then be referenced as Slot 6, Drive 2. 
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Put the diskette to be formatted (initialized) into a 
free drive of your Apple //e or //c and type the Slot and 
Drive number of this drive at the current cursor position as 
follows (we are assuming that the 'boot' drive is being 
used) : 

Stemwriter Utilities Formatting a Volume _ Version 1.0 

Format Medium in Slot :6 


Press:<arrows> to select <RETURN> to accept <escape> to exit 


Press RETURN. The center of your screen will now read: 

Format Medium in Slot :6 
Drive :1 

Adjust the Drive number to suit, and press RETURN to accept 
it. The first thing that happens, is that a check is made 
to see if the selected volume has already been formatted. 
If so, the message: 

Destroy contents of t/MYVOL] Y/N : 


appears. Had you inadvertently picked up a diskette 
containing valuable information, or had referred to the 
wrong drive, no harm will be done. Simply press "N", and 
the formatting utility will once again ask for the Slot, and 
Drive number. You can then correct your previous error, and 
start again. Had you answered "Y" to the above question, or 
had the diskette been unformatted, you would have been asked 
the question: 

With the Volume Name:/BLANK00 


The default volume names BLANKOO through to BLANK99 are 
suggested, in turn. The default names are quite useful when 
preparing a batch of formatted diskettes, when the actual 
volume name wont be known until each diskette is put to use. 
The Stemwriter Utilities program is suggesting you assign 
the name, 'BLANKOO' to the diskette being formatted. If you 
prefer another name, e.g. 1 DEMODISK 1 , press the left arrow 
key until the name 'BLANKOO' is removed and then type the 
name 'DEMODISK' on your screen in its place. N,B .: The 
Volume Name must be in capital letters. If not, you will 
get the message: 

Message : Invalid Volume Name 
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When you have an acceptable Volume Name displayed on your 
screen, press RETURN. If you are formatting a previously 
unformatted diskette, the Stemwriter 'Format a Volume' 
Utility will begin to format the volume (diskette) in the 
nominated drive (Slot 6, Drive 1) and the messages 

Message :Formatting.... 

and 

Message initializing.... 

will appear successively near the top of your screen. 
When the formatting is complete, the following message will 
appear: 

Message : Task complete with no errors 
Press <SPACE> bar to continue 

On pressing the space bar, you are returned to the beginning 
of the 'Format a Volume' command. 

16.2.2 Create A Vanilla File 

A Vanilla file is one from which all of the Stemwriter 
dependent commands and codes have been stripped, i.e. all 
conditional line breaks become unconditional line breaks; 
the new paragraph command is replaced by two carriage 
returns; all special fields including underline, bold, etc, 
are removed and all new page commands are removed. A 
Vanilla file is thus a bland ASCII file, and can be used for 
transferring text between word processors, for tele¬ 
communications or for sending to a typesetting machine, etc. 

To create a vanilla file, move the cursor until it is 
adjacent to the 'Create Vanilla File' option of the File 
Utilities menu and press RETURN. Your screen will now read: 

Stemwriter Utilities_Create Vanilla File_Version 1.0 


Each <cr> followed by <lf> Y/N: 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

If your current application requires that all carriage 
returns be followed by a line feed, type Y, if not, type N. 
Press RETURN. The center of your screen will now resemble: 
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Each <cr> followed by <lf> Y/N: Y 
Vanilla is TEXT/ASCII File T/A: 

If you would like your Vanilla file to be in the form of an 
Apple /// Pascal text file, type T, otherwise type A. For 
information on File formats, refer to the Reference Section, 
Chapter 12, of this manual. Press RETURN. The center of 
your screen should now resemble: 

Each <cr> followed by <lf> Y/N:Y 
Vanilla is TEXT/ASCII File T/A:A 
Enter Full Pathname for Source/Destination 

Source File : 

You must now type the pathname of the file you wish to make 
a vanilla copy of, e.g. 

Source File :/MYTEXT/EX.DOC.l.LIB 


Press RETURN. If you inadvertently nominated a segmented 
file rather than a whole file, the message 

Message : Source File is wrong Type 

will appear near the top of your screen. You will then be 
given another opportunity to type an acceptable file 
pathname. 


If the nominated source file is a whole file, you are 
now asked for the pathname of the destination Vanilla file, 
as follows: 


Source File 
Destn File 

: /MYTEXT/EX.DOC.1.LIB 


Type the pathname of the destination 
follows: 

file on your screen as 

Destn File 

:/MYTEXT/EX.DOC.1.VAN 


Press RETURN 

. When the vanilla file 

is created, the message 

Message : Task Complete with no Error 

Press <SPACE> bar to continue 


will appear near the top of your screen. On pressing the 
space bar, you are returned to the beginning of the 'Create 
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Vanilla File' option of the 'File Utilities' menu. 

If your diskette is so full that there is insufficient 
space on it to open the vanilla file, the message 

Message : File Opening Error 

will appear near the top of your screen. Also if there is 
sufficient room on the diskette to open the vanilla file, 
but insufficient room to write the file contents onto the 
disk, the message 

Message : File System Error 
will appear near the top of your screen. 

To return to the 'File Utilities' menu, press ESCAPE. 

16.2.3 Copying A Segmented File 

Every segmented file has a particular Segment Table 
associated with it. The Segment Table contains information 
which permits a nominated segment to be referred to 
directly. The Segment Table file is named by Stemwriter 
when the original Segmented file is created. Thus, when you 
copy a segmented file, the associated Segment Table must 
also be copied. However, the name allocated to the Segment 
Table being copied, may have already been allocated to 
another Segment Table at the destination. Therefore, the 
Segment Table file may need to be re-named during copying. 
The 'Copy a Segmented File' command of the Stemwriter 
Utilities program does this but the 'Copy File* option of 
the ProDOS Filer does not. 

To use this Utility to copy a segmented file directly 
from one volume (diskette) to another, you must have two 
disk drives. Otherwise, you may need to use the Stemwriter 
program, and, by loading and saving/adding successive groups 
of segments, transfer the file piecemeal. 

If you are continuing on from Lesson 16.2.2, the 'File 
Utilities' menu will be displayed on your screen. If not, 
load the Stemwriter // Utilities program and select the 
'File Management' option, as described at the beginning of 
Lesson 15. Your screen will now appear as follows: 
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Stemwriter Utilities _ File Utilities _ Version 1.0 

: Create Vanilla File 
: Copy Segmented File 
: Combine Segmented Files 
: Format a Volume 


Press:<arrows> to select <RETURN> to accept <escape> to exit 


To copy a segmented file, move the cursor using the 
up/down arrow keys, until it is adjacent to the 'Copy 
Segmented File' option and press RETURN. Your screen will 
now read: 

Stemwriter Utilities Copy Segmented File Version 1.0 
Source File: 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

Type the pathname of the file to be copied onto your screen 
at the current cursor location, e.g. 

Source File :/MYTEXT/ARTICLES 

Press RETURN. You are now asked for the pathname of the 
destination file as follows: 

Source File :/MYTEXT/ARTICLES 
Destn File : 

Type the pathname of the destination file on your screen at 
the current cursor position, e.g. 

Destn File :/MYTEXT/ARTICLES.1 

Press RETURN. When the nominated segmented file has been 
copied, the message 

Message: Task Complete with no Error 

Press <SPACE> bar to continue 

will be displayed. On pressing the space bar, you are 
returned to the beginning of the 'Copy Segmented File' 
command. If you do not wish to copy any more segmented 
files, press ESCAPE to return to the File Utilities menu. 
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16.2.4 Combining Segmented Files 

To combine two segmented files into one large segmented 
file, move the cursor until it is adjacent to the 'Combine 
Segmented Files' option in the File Utilities menu. Press 
RETURN. Your screen should now appear as follows: 


Stemwriter 

Utilities Combine Segmented Files Version 1.0 

Donor File 

* 

Press:<arrows: to select <RETURN> to accept <escape> to exit 


You must now type the 

pathname 

of 

the segmented 

file which 

is to be 
file, e.g. 

appended to 

the end 

of 

the recipient 

segmented 

Donor File 

: /MYTEXT/ADDRESS 





Press RETURN. You must now type the pathname of the 
recipient segmented file onto your screen, e.g. 

Recipient File :/MYTEXT/ARTICLES.1 


Press RETURN. The segments from the donor file, 

/MYTEXT/ADDRESS, will now be appended to the end of the 
recipient file, /MYTEXT/ARTICLES. 1. When this is complete, 
the message 

Message : Task Complete with no Error 

Press <SPACE> bar to continue 

will be displayed near the top of your screen. On pressing 
the space bar, you are returned to the beginning of the 
'Combine Segmented Files' command. If you do not wish to 
use this command again at this point in time, press ESCAPE 
to return to the 'File Utilities' menu. Press ESCAPE again 
to return to the Master Menu of the Stemwriter // Utilities 
program. 

16.3 Maximising Your Workspace 

Because the Stemwriter // program is too large to fit 
entirely within the main memory map of your Apple //e or 
//c, parts of the program are contained in 'overlays'. That 
is, parts of the Stemwriter program share the same portion 
of the main memory map when being executed. The overlays 
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exist as code files which are copied into the main memory 
map when required. 


The most frequently used functions of Stemwriter are 
memory-resident at all times, and less frequently used 
functions have been assigned to the overlay files, as 
follows: 


Overlay File Name 


Description 


STM.00 

STM.01 
STM.02 
STM.03 


Form Letter Generation, Column 
and Text Alignment 
Printer Commands 
File House-keeping Commands 
Formatting Commands 


If you have already completed the Stemwriter // 
Tutorial, you were probably unaware that parts of the 
Stemwriter program were being overlaid, for example, when 
formatting or printing a document/file. This is because the 
Stemwriter // program is supplied to you pre-configured to 
load the overlays into the RAM disk in your Apple //e or 
//c's auxiliary memory at start-up time. This enables you 
to conveniently use all of Stemwriter //'s capabilities in a 
single disk environment, at the cost of a reduction in 
workspace of about 8000 characters. 


However, if it is critical that you recover the extra 
workspace, you can arrange for the overlays to be drawn from 
the Stemwriter Program diskette, or from any other disk to 
which they may have been copied, when, and as, needed. This 
will give a document workspace of around 51k bytes. To 
configure the Stemwriter // program to do this, ensure that 
the Stemwriter program diskette is in the boot drive of your 
Apple //e or //c. Load the Stemwriter Utilities Program in 
the usual way, to display the main menu: 

Stemwriter // Utilities _ Master Level _ Version 1,0 

> : Initialization 
: File Management 
: Sort/Select Segment Records 
: Word/Sentence Count 
: Labels 
: Exit Program 

Press: <arrows> to select <RETURN> to accept 
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Using the up/down arrow keys in the usual way, move the 
cursor until it is adjacent to the 'Initialization' option 
of the Master Menu and press RETURN. Your screen will now 
appear as follows: 

Stemwriter // Utilities Initialization Version 1.0 

> : Select Printer Driver 
: Configuration Tables 

Press:<arrows> to select <RETURN> to accept <escape> to exit 

Move the cursor until it is adjacent to the 'Configuration 
Tables' option of the Initialization Menu and press RETURN'. 
Your screen will now read: 

Stemwriter // Utilities Configuration Tables Version 1.0 

Edit Utilities Table : 

Save Table as File : 

Error : 

> : Edit User Definable Keys 
: Edit Printer Attributes 
: Overlay Prefix 
: Edit Paper Sizes 
: Edit Character Code & Size 
: Edit Printer Control Table 
: Save Edited Parameters 

Press:<arrows> to select <RETURN> to accept <escape> to exit 

We are going to edit the Stemwriter Initialization 
data, which is contained in the file STEM.CONFIG on the 
Stemwriter program diskette. So, type STEM.CONFIG at the 
current cursor position on your screen and press RETURN. 
This portion of your screen will now read: 

Edit Utilities Table :STEM.CONFIG 
Save Table as File : 

When the file has been read, the cursor will move adjacent 
to the list of options. Using the up/down arrow keys in the 
usual way, move the cursor until it is adjacent to the 
'Overlay Prefix' option and press RETURN. Your screen will 
now read: 
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Stemwriter // Utilities _ Overlay Prefix _ Version 1.0 

Overlay Prefix :/RAM 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

The Overlay prefix will show the pathname used to find the 
Overlay files. In all probability, it will show on your 
screen as /RAM, signifying that the overlay files are to be 
copied to the RAM-disk when Stemwriter // is 'booted', and 
drawn from there when, and as, required. To change the 
Overlay Prefix from /RAM to /STEMWRITER, press the left 
arrow key three times to remove 'RAM' and then type 
'STEMWRITER' in its place. Your screen will now appear as 
follows: 

Stemwriter // Utilities _ Overlay Prefix _ Version 1.0 

Overlay Prefix :/STEMWRITER 


Press:<arrows> to select <RETURN> to accept <escape> to exit 

Press RETURN. To save the change you have just made to the 
Utilities Table, STEM.CONFIG, move the cursor until it is 
adjacent to the 'Save Edited Parameters' option of the 
Configuration Tables menu and press RETURN. The cursor will 
move to near the top of your screen, which will now read: 

Edit Utilities Table : 

Save Table as File :STEM.CONFIG 

Press RETURN. The top portion of your screen will now read 
as follows: 

Edit Utilities Table : 

Save Table as File :STEM.CONFIG 

Overwrite Existing Table? Y/N: 

Press Y for Yes followed by RETURN. The new configuration 
table data will now be saved. To return to the Master Level 
Menu of the Stemwriter Utilities program, press the ESCAPE 
key twice. Until changed, the Stemwriter program will in 
future seek its overlay files from the volume /STEMWRITER, 
when they are required. 
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16.4 Word/Sentence Count 


Assume we are at the Master menu level of the 
Stemwriter Utilities program. If you are already using the 
Stemwriter Utilities, press ESCAPE until this is the case. 
Otherwise, enter the Stemwriter Utilities program as 
described at the beginning of Lesson 15. Select the 
'Word/Sentence Count' option by moving the cursor with the 
up/down arrows, and then pressing RETURN. Your screen 
should then resemble: 

Stemwriter Utilities _ Word/Sentence Count _ Version 1.0 

Count File: 


Press:<arrows> to select RETURN to accept <escape> to exit 

Enter the pathname to the file to be counted, like so 


Count File :/MYTEXT/EX.DOC.1.LIB 


The disk will whirr, and the center of your screen will then 
resemble: 


Message : Task complete with no errors 
Press <SPACE> bar to continue 


Statistics for File 

Words in File 
Sentences in File 
Average Word Size 
Words/Sentence 


/MYTEXT/EX.DOC.1.LIB 

: 251.0 

: 17.0 

: 5.1355 

: 14.7647 


When you press the <SPACE> bar, the Utility will prepare 
itself to count the words in another file. 


16.5 Auxiliary Characters 

Some printers, such as dot matrix printers, can select 
different font styles 'on the fly'. Stemwriter has been 
given the ability to select font styles 'A' to 'D' to 
exploit this facility. This is how different character 
styles, such as Italic, etc., should be selected. The 
command sequences necessary to achieve this are entered in 
the Printer Command Tables, as detailed in Part 4, Chapter 
2.2.7 of the Utilities. However, it is also possible that a 
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new font style could represent characters from a different 
alphabet. It would be nice to have the characters appear on 
the screen as they will appear when printed. In this case, 
treat them as Auxiliary Characters, in the way to be 
described. 

Other printers, such as daisy-wheel printers, can 
actually print an extended character set, of up to 128 
characters, compared with the standard ASCII set of 94 
printable characters. Printers with this ability can switch 
to the extended character set under software control. 

Stemwriter, ip addition to the standard 94 characters 
inscribed on the keyboard keys (the standard ASCII character 
set), can display the shapes of an additional 83 characters. 
These have been designated as Auxiliary Characters, and are 
invoked by pressing Open Apple in conjunction with a 
character key. For example, pressing Open Apple "a" will 
produce the Greek lower case "alpha". When you receive 
Stemwriter, the Auxiliary Character set is pre-designed to 
give the shapes of the Greek character set. The exact 
transliteration between the Roman characters inscribed on 
the keys, and the Greek character shapes produced, is given 
in Table 4, Chapter 2 of the Reference Section of this 
manual. 

If your printer has the ability to produce an extended 
character set, and you wish to take advantage of them, then 
these are the steps you must follow in preparing your 
printer. If you are fortunate, all this information will be 
in your printer's manual. Otherwise, some experimenting 
with the printer will be necessary. 

(1) Determine the command codes which allow your printer to 
access the alternate font, or extended characters 

(2) Determine the command codes which return your printer 
to printing the standard character set. 

(3) Print out the entire extended character set of the 
printer, and determine the equivalence between the 
standard and extended character codes. 

Now that you have determined what your printer can do, 
it is time to decide which extended character you wish to 
have associated with which key, and then design the 
character shapes to suit (Utilities, Section 2.2.6). If 
you will be using the Greek character set, this work has 
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already been done for you, so skip to Section 16.5.2 of this 
lesson. 


16.5.1 Designing Auxiliary Character shapes. 

Ensure that the Stemwriter Utilities program is loaded, 
as detailed previously. Choose the option 'Initialization' 
from the Master Menu, and then the option 'Configuration 
Tables'. As prompted, enter the name of the Configuration 
Tables file, STEM.CONFIG. Then choose the option 'Define 
Shape of Aux. Char Set'. When all this has been done, your 
screen will show the shape maker menu. Now proceed to 
design your shapes as detailed in Part 4, the Utilities, 
Section 2.2.6. 

When you are satisfied with your shapes, press ESCAPE 
to return to the Configuration Tables Menu. You are now 
ready for the next step. 

16.5.2 Matching Auxiliary shapes to Printer Output 

Firstly, a digression. In what follows, we will be 
using hexadecimal based numbers, instead of the familiar 
decimal numbers. Hexadecimal numbers have a base of 16, and 
the individual digits are represented by the numbers 0 to 9, 
and then the letters 'A' to 'F'. Thus, the hexadecimal 
number OF represents the decimal number 15. Further, the 
hexadecimal number 41 represents the decimal number 65 
(4*16+1 cf 6*10+5). 

Well, you have now designed your character shapes, and 
matched them to your keyboard. The next step is to tell 
Stemwriter how to convert the keyboard codes into the 
printer codes. To understand what follows, remember that 
both Stemwriter and your printer, store and recognize 
characters as numbers. For exanple the number 41 
hexadecimal represents the character 'A'. Thus, to print 
the character 'A', Stemwriter sends the code 41 to the 
printer. By relating the character shapes to the keyboard, 
we have determined that Stemwriter will send the code 
associated with that key to the printer, and expect it to be 
printed. For example, we have agreed that Open Apple 'a' 
will produce the character 'alpha'. Stemwriter produces the 
code El in this case, and expects the printer to recognize 
it as 'alpha'. However, the printer, for arguments sake, 
might expect to receive the character code 43. Thus, we 
need to translate the codes sent to the printer. We do this 
by editing the Character Code conversion table. 
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From the 'Configuration Table' menu, select the task 
'Edit Character Code and Size'. When this is done, the 
center of your screen will appear as: 

: Character Code Table 
: Character Size Table 

Select the option 'Character Code Table'. Now refer to 
Section 2.2.5 of the Utilities, and proceed from there. 
Remember, you will be dealing with the codes in the range AO 
through to FF. When you are done, press ESCAPE twice to 
return to the Configuration Tables menu. 

16.5.3 Selecting the Extended Characters 

To this point we have designed our character shapes, 
and matched up the Stemwriter and printer codes. We now 
need to be able to tell the printer when it is printing 
standard characters, and when it should be printing the 
Auxiliary characters. Study the manual which came with your 
printer, and determine the code sequences which are required 
to 'switch' your printer between character sets. 

From the Configuration Tables menu, choose the 'Edit 
Printer Control Table' option. You will then be asked to 
select between: 


: Basic Commands 
: Extended Commands 

Choose the Extended Commands option. Refer to Part 4, the 
Utilities, Section 2.2.7, to see how your screen should 
look, the commands available, and how to set them. We are 
interested in Extended Command 10, which is to receive the 
code which selects the extended or Auxiliary characters, and 
Extended Command 00 (Select Font Style A), which is to 
receive the command code which restores the standard 
characters. 

When you have performed these tasks, return to the 
Configuration Tables Menu, select the 'Save Edited 
Parameters' option, and. save the results in the file STEM. 
CONFIG. 

Stemwriter is now customised to show and print your 
extended characters, as matched to your very own keyboard 
layout. 
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16.6 Exiting The Stemwriter // Utilities Program 


To re-enter the Stemwriter program itself from the 
Stemwriter Utilities program, move the cursor, using the 
up/down arrow keys, until it is adjacent to the 'Exit 
Program' option of the Master Menu and press RETURN. Your 
screen will read: 


ENTER PREFIX (PRESS "RETURN" TO ACCEPT) 
/STEMWRITER/ 

Press RETURN. Your screen will now read: 


ENTER PATHNAME OF NEXT APPLICATION 

Type the following at the current cursor location on your 
screen: 

STEM.SYSTEM 

Ensure that the Stemwriter // program diskette is contained 
in the boot drive of your Apple //e or //c and press RETURN. 
The Stemwriter // program itself will now be loaded into the 
computer's memory and the Stemwriter greeting screen will be 
displayed. 
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17.0 LESSON 17 - GENERAL TIPS ON USING STEMWRITER 

17.1 Document Identification 


A very good habit to get into, is to put a Comment at 
the top of every document you create, containing the name of 
the file that the document is to be saved under. This will 
save confusion when it comes to editing a file and then 
updating the original file on disk. You will be less likely 
to save the edited document under the wrong file name. 
Similarly, if you ALWAYS save your file with Backup, you 
have an extra margin of safety to recover from just such a 
mistake, if it were to happen. 

17.2 When The Memory Is Full 

When you have almost completely filled the computer's 
memory (you have a maximum of approx. 51K in a 128K Apple 
//e or //c), you will receive the following warning in the 
command line: 

Memory almost full :: FINISH UP NOW 


You will continue to get this warning for the next 256 
characters entered. If you continue to ignore the 'Memory 
Full' warning, the program will refuse to accept any further 
text and the following message will appear in the command 
line: 

Memory full :: must save to disk 


At this point, you must either clear one or more 
documents from memory, or save the current document as a 
disk file. If you wish to move the tail of a large document 
to a new document so that the saved document ends at a 
convenient place, you may do this, as enough memory has been 
kept aside to permit the opening of a new document. The 
shifted fragment of text will thus form the beginning of the 
continuation document. 

17.3 Handling Very Large Documents 

It is preferable to save very large documents, such as 
books, as several files, each of which corresponds to a 
natural break in the text, such as one chapter. 

However, if you insist, Stemwriter can handle text 
files too large to fit into the computer's memory using the 
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following artifice: 

When the memory initially fills, you must save the 
large document as a segmented file, with each page being one 
segment. If there are no forced page breaks within the 
document, it will be saved as one large segment, with a new 
page symbol inserted as the first character. You can then 
add more segments to the original segmented file, as large 
'pages' until the entire document is complete. In this way, 
you can theoretically handle documents up to 16 megabytes in 
size, using the Stemwriter program. 


For editing, the 'pages' can be accessed as sequential 
segments, and added to a new segmented file after editing is 
complete. The Save with Backup feature facilitates this. 

To format such a large document, you will have to 
format from File to File with Page Preview on. When you do 
this, the Formatter treats the segmented file as though it 
were a whole file and the page break directives from the 
segmented file are discarded. ( N.B : Page break directives 
saved in whole files are not discarded.) This is not really 
a problem, as any desired page breaks may be inserted into 
the text contained in the source file scratchpad, as each 
page is formatted. 


17.4 Indexing Your Word Processing Sessions 


This involves creating a segmented file called INDEX, 
within each directory level on a disk (volume). Then, as 
each new file is created in that directory level, compose a 
short paragraph containing the file name and a brief 
description of the contents, and add it to the INDEX file. 
A typical INDEX entry might be: 


File name 
File Type 
Created by 
Contents 


SAMPLEFILE 
Whole File 
John A Jones 

This is a short sample file which does not 
contain much text. 


A sample index file exists on the diskette, /MYTEXT. Load 
/MYTEXT/INDEX into a clear Document of your computer's 
memory, and see what has been said about the files on 
/MYTEXT. 

The benefits of such an indexing scheme are very 
significant as the 15 character limit on file names forces 
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them to be very cryptic. Further, one can see at a glance 
what files are in a Directory or Sub-Directory and what 
their contents are, without the necessity of loading each 
file into memory and viewing its contents. Particularly on 
the hard disk, PROFILE, you will be very appreciative of the 
minimal effort needed to fully and conveniently keep track 
of your files in this manner. 

17.5 Organizing And Maintaining Segment Records 

Address Lists and Reference Lists must be maintained. 
That is, from time to time, new records will be added and 
old ones will be modified or deleted. This exercise is done 
using the Stemwriter program. The recommended procedure for 
handling large numbers of records is to divide the records 
into files which will conveniently fit into the computer's 
memory (up to 400 records), and to use the file names as a 
broad classification. For example, a large address list may 
be saved in a family of files in the subdirectory /ADDRESS, 
as follows: 

/PROFILE/ADDRESS/A.TO.C 
/PROFILE/ADDRESS/D.TO.F 
/PROFILE/ADDRESS/G.TO.M 
/PROFILE/ADDRESS/N.TO.T 
/PROFILE/ADDRESS/U.TO.Z 

Similarly, a Reference list may consist of a family of files 
in the Subdirectory /REFERENCE. When the records are 
organised in this way, the addition, deletion, or correction 
of records is quite convenient. If a file grows too large 
to be handled all at once by Stemwriter, it may be split in 
two, and the two new files be named according to the above 
suggested scheme. 

As an alternative to the above, Stemwriter may be used 
to handle a large file, as follows. Addition of new records 
causes no problems - it is simply a matter of creating the 
record(s) in a Stemwriter Document, adding it to the 
required file and then sorting it into place. Altering or 
deleting a record is somewhat more difficult. The procedure 
is to load into memory as many records as will fit (for 
arguments sake, 1 to 400). Save these records as a new 
file. Read in the next group of records in numerical order 
(say records 401 to 800), and add them to the newly created 
file. Continue this procedure until the record to be edited 
or deleted is reached, carry out the corrections, and then 
add the results to the new file. Continue loading to memory 
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and adding to the new file, until all records have been 
copied over from the old file to the new one. 
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REFERENCE SECTION 

1.0 INTRODUCTION 

Any computer program has three basic divisions of 
function, namely: 

(a) Getting the information into the computer. 

(b) Doing something meaningful with it. 

(c) Getting something useful out. 

For a word processing and document preparation system, 
these three divisions involve: 

(1) The design of the User Interface. 

(2) The capabilities 'of the program for text 
manipulation. 

(3) Formatting and printing capabilities. 

Throughout this Section, textual information is 
referred to as a ’document' when in the computer's memory, 
and as a 'file' when saved to disk. 

1.1 User Interface 


Stemwriter // offers an original solution to the User 
Interface problem, which provides a balance between help for 
inexperienced and intermittent users, and not impeding 
experienced users. The design has been influenced by the 
Smalltalk ideals of 'recognizing and pointing', and 'mode- 
free' operation. The command line design for option 
selection provides an efficient way to do the first, while 
at the same time obviates the need for voluminous and 
tedious Help Files. No commands in Stemwriter are 'too 
difficult' to use. 

Modes are discarded almost entirely. There are few 
operations in Stemwriter which can be considered as modes. 
Correction and entry of text is achieved by simply moving 
the cursor to the desired location, and typing. Just like 
moving a pen or pencil over a sheet of paper. There are no 
layered menus to wade through, no 'Insert mode', no 'Delete 
mode', or any other Mode. 
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'What you see is what you get' is exemplified by 
providing on-screen super and subscripting, underline, bold 
(shown as inverse video), and overstrike. Viewing of the 
text is facilitated by bi-directional vertical scrolling, 
horizontal scrolling, and split screen viewing. 

1.2 Program Capabilities 

Stemwriter offers the standard text manipulation 
capabilities found on most good word processors, and adds a 
few, important for document preparation, which are not 
usually found. For example, column Move/Copy/Wipe, column 
alignment, multi-column formatting, easy transfer of text 
between documents through multiple documents in memory (up 
to 8), user definable function keys, 540 permutations on the 
Find/Replace/Verify operation, automatic re-margining when 
appropriate, a generalised boilerplating facility, 
encryption of sensitive files, backing up of files, sorting 
and selecting records from files, form letter generation, 
forms creation and fill-in, and so on. The multiple 
documents feature is supported by a sophisticated Memory 
Manager, which provides for efficient memory usage, and 
makes most text manipulations, document-size independent, in 
their time of execution. 

The Stemwriter program, in conjunction with the 
Utilities program, offers Form Letter generation, and the 
capability for maintaining and processing textual records, 
such as address lists, reference lists, and so on. 
Particular capabilities include the sorting and selection of 
records, and the merging of list text with form letter 
templates. 

1.3 Formatting And Printing 

The formatter offers extensive formatting capability, 
for producing print-ready files or documents. Headers and 
Footers, alternating margins, reserved space for tables, 
photographs, graphs, footnotes, local formatting, fill- 
justified text, hyphenation control, up to four text 
columns, and optional interaction with the formatting 
process, are all offered. 

A very vexing problem for word processors is the lack 
of standardisation of printer control codes. Although all 
printers perform the same basic operations, there is little 
or no standardisation in the way these are implemented. 
Stemwriter attacks this problem by incorporating an Abstract 
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Printer. The task of the Abstract Printer is to conceal the 
printer-specific differences from the text to be printed, 
whilst supporting the advanced printer features usually 
required to produce well-presented text. The Abstract 
Printer converts the printer commands included in Stemwriter 
text into the appropriate command sequences recognised by 
the specific printer. It will even convert the ASCII 
character code used by Stemwriter to any arbitrary 
character code recognized by the printer! In this way, all 
Stemwriter files are standardised, and may be printed on any 
printer, without alteration. All that has to be changed is 
the contents of a few tables in the Abstract Printer. 

1.4 Getting Started 

When Stemwriter is started up, the screen initially 
shows the Stemwriter greeting. The program is initiated by 
pressing the SPACE bar once. The commencement process 
consists of a sequence of command lines requesting the 
following information: 

Enter or Confirm Today's Date. 

The Document to be used. 

The Window to be used to view the Document. 

The line width, line indent, and paragraph indent. 

When this information has been satisfactorily supplied, 
the screen clears, and the program is ready to accept text 
into the chosen document. 
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2.0 THE KEYBOARD 

Each key on the Apple //e and Apple //c keyboard has 
Auto-Repeat if held down for any period of time. For 
Stemwriter, the keyboard has been organized as System Keys, 
Control Keys, Character Keys, and User Definable Keys. The 
System and Control keys are used to invoke the Stemwriter 
commands. In all, they invoke 23 single keystroke commands, 
and 17 command groups. 

2.1 Type Ahead 

Stemwriter // implements in software, a type-ahead 
facility for capturing keystrokes. Whilst many procedures 
are active, the keyboard is continually scanned, and any 
waiting keystrokes are placed in a ring buffer, from which 
they are drawn when keyboard input is requested. This 
facility prevents the loss of keystrokes during screen 
clearing, writing to the screen, and screen scrolling. This 
facility is active except when the following messages are 
displayed : 

'Stemwriter Busy' 

'Please Wait' 

'Formatting Page nn' 

These messages appear when the CPU is too busy to scan the 
keyboard, and preserve keystrokes. During these times, the 
entry of keystrokes is not, in any event, required. 

If the type ahead buffer overflows, the bell sounds, 
and the most recent keyboard character is rejected. 

The type-ahead buffer may be flushed of waiting 
characters by pressing Control-6. 

2.2 System Keys 

The System Keys are: 

Open and Closed Apple with keys at top of keyboard. 

Arrow keys with Open Apple. 

Tab with Open Apple. 

Escape with Open Apple. 

Each system key when depressed, causes the presentation 
a command sequence to the Stemwriter program. Table 1 shows 
the organization of the System Keys. 
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2.3 Control Keys 

Escape 
Arrow Keys 
Tab 

Return 

Each Control key has a dedicated action associated with it, 
as shown in Table 2. 

2.4 User Definable Keys 

A...J (Case does not matter) with Closed Apple. 

Each User Definable key can represent up to 31 
keystrokes, which may consist of printing characters, other 
User Definable keys, or System Keys. It is thus possible 
that pressing one User Definable Key, can result in the 
entry of commands and text from several keys. By chaining 
User Definable keys in this way, up to 300 characters may be 
entered by a single keystroke. User Definable keys are 
described in detail in Section 6.0. 

2.5 Character Keys 

Stemwriter // is capable of displaying the standard 
ASCII character set, as well as an Auxiliary character set, 
which can be designed by the user. The Auxiliary character 
set is particularly useful when Stemwriter is combined with 
a printer capable of printing an extended character set. 

2.5.1 Auxiliary Characters 

The Auxiliary character set is obtained by using the 
Open Apple key as a modifier key. For example, pressing 
'Open Apple a' will display the lower case Greek letter 
alpha. 

As supplied, the Auxiliary Character set is pre-defined 
to display the Greek character set, along with some useful 
math symbols. The correspondence between the Greek 

characters, and the normally used Roman characters is shown 
in Table 4. This is, as far as possible, an exact 
transliteration. To obtain a print-out of the Auxiliary 
characters, three things are required: 
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(1) A printer which can print an extended character set 
containing the Greek characters. 

(2) The Stemwriter Code Conversion Table for the Auxiliary 
Character Set must be set to correctly map the codes 
understood by Stemwriter onto the codes understood by 
the printer. 

(3) The Printer Control Table must be set with the correct 
sequence to invoke the extended character set at the 
printer, when and as required. 

In all, 86 possible user modifiable Auxiliary 
characters are available. 

2.5.2 Sticky Space 

Many times, one is faced with the need for being able 
to place spaces in the text, which are treated as normal 
alphabetical characters. That is, they cannot be "filled" 
or stretched by the formatter, and they are not potential 
line break positions. 

This function is fulfilled by the so-called 'sticky 
space', which is printed as a space, but is treated by 
Stemwriter as though it was a normal alphabetical character. 
The Sticky Space is created by pressing Open Apple with the 
Space bar. A special character is shown on the screen to 
identify the character as a Sticky Space. If you don't like 
the symbol provided, you may design your own, using the 
Auxiliary Character Shape Maker of the Utilities program, 
for the Auxiliary character. Open Apple space. 
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Table 1 

System Key Table 


Code 

Key 



128 

Open 

Apple 

- 

129 

Closed Apple 

2 

130 

Closed Apple 

= 

131 

Closed Apple 

0 

132 

Closed Apple 

1 

133 


<del> 

134 

Closed Apple 

3 

135 

Closed Apple 

4 

136 

Open 

Apple 

left arrow 

137 

Open 

Apple 

tab 

138 

Open 

Apple 

down arrow 

139 

Open 

Apple 

up arrow 

140 

Closed Apple 

5 

141 

Open 

Apple 

return 

142 

Closed Apple 

6 

143 

Closed Apple 

7 

144 

Closed Apple 

8 

145 

Closed 

Apple 

9 

146 

Open 

Apple 

2 

147 

Open 

Apple 

A 

r—) 

V 

148 

Open 

Apple 

0 

149 

Open 

Apple 

right arrow 

150 

Open 

Apple 

1 

151 

Open 

Apple 

= 

152 

Open 

Apple 

3 

153 

Open 

Apple 

4 

154 

Open 

Apple 

- 

155 

Open 

Apple 

escape 

156 

Open 

Apple 

6 

157 

Open 

Apple 

7 

158 

Open 

Apple 

8 

159 

Open 

Apple 

9 


Description 
Free Memory 

Set block/Coluitn marker 

Repaint 

Cut/Paste 

New Para/Advance by para 

Rub Character 

Force New Page 

Choose Special Fields 

Backup one word 

Set tab envircnment 

Subscript 

Superscript 

Line/Column alignment 

Move to last line head 

Print 

File Operations 
Jump 

Choose Document 
Select Block/Coluim Op. 

Clear Document 
Format Document 
Advance one word 
Back up one Para. 

Set User Key 
Flush Printer 

Biable/t>isable Field Markers 
Toggle Underlining 
Overstrike 

Advance/Reset Printer 
File Operations 
Find/Replace/Verify 
Set line/page breaks 
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Table 2 
Control Keys 


Code 

Key 

Description 

2 

Control-B 

Change Interpreter 

8 

left arrow 

back up one character 

9 

Tab 

Advance to next tab step 

10 

down arrow 

Advance one line 

11 

up arrow 

Back up one line 

13 

return 

New line or next line head 

17 

Control-Q 

Halt User Definable Keys 

21 

right arrow 

Advance one character 

26 

Open Apple 5 

Form Letter Creation 


Table 3 


Character Cedes 

0. .31 

Control Codes 

32..127 

Printing ASCII characters 

128..159 

System Keys 

160 

'Sticky' 

Space 

161..175 

Primitives or Auxiliary Characters 

176..185 

User Definable Keys 

186..255 

Primitives or Auxiliary Characters 
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Reman 
(Keyboard) 
Code Char 

Cl A 

C2 B 

C3 C 

C4 D 

C5 E 

C6 F 

C7 G 

H 
I 
J 
K 
L 
M 
N 
0 
P 
Q 
R 
S 
T 
U 

V 

w 

X 

Y 
Z 


Table 4 

Roman to Greek Transliteration 


Greek 

Roman 

Greek 

Name 


(keyboard) 




Code Char 

Code 

Char 

Code 

Char 

.... A 

El 

a 


a 

Alpha 

.... B 

E2 

b 


6 

Beta 

.... 

E3 

c 


- 

- 

.... A 

E4 

d 


6 

Delta 

.... E 

E5 

e 


e 

Epsilon 

$ 

E6 

f 


0 

Phi 

.... r 

E7 

g 


Y 

Ganna 

.... H 

E8 

h 


n 

Eta 

.... I 

E9 

i 


i 

Iota 

.... Y 

EA 

j 


i 

Cap Sigma 

.... K 

EB 

k 


K 

Kappa 

.... A 

EC 

1 


\ 

Lambda 

.... M 

ED 

m 


P 

Mu 

.... N 

EE 

n 


V 

Nu 

.... 0 

EF 

o 


o 

Omicron 

TT 

FO 

P 


it 

Pi 

.... ^ 

FI 

q 


V> 

Psi 

.... P 

F2 

r 


p 

Rho 

.... I 

F3 

s 


a 

Sigma 

.... T 

F4 

t 


T 

Tau 

r 

F5 

u 


V 

Ups i Ion 

0 

F6 

V 


e 

Theta 

.... n 

F7 

w 


0) 

Cmega 

X 

F8 

X 


X 

Chi 


F9 

y 


5 

Xi 

.... z 

FA 

z 


5 

Zeta 


Note: Enter the printer Code against the corresponding 

Greek Character. For non-available characters, enter 
the <SPACE> code (20 hex). The Roman Codes are the 
ASCII codes understood by Stemwriter, and give the 
Row, Column of the Auxiliary Character Code 

conversion table. The printer Codes for the Greek 

letters should be entered in the body of the 
Auxiliary Character Conversion Table, at the 
ordinates specified by the Roman character code. 
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3.0 USER INTERFACE 

The User interface has been designed to make all 
commands equally accessible. This has been achieved by 
careful Command Line design, embodying the concept of 
'recognizing and pointing' rather than 'remembering and 
typing'. Heavy usage is made of the arrow keys for command 
option selection, providing a mouse-like operating 
environment with the good ergonomics of never having to 
remove one's hands from the keyboard. Further, all eye 
scanning is horizontal, and the information always appears 
in a pre-determined place on the screen. 

When a System Key is pressed, the appropriate command 
line is displayed above the currently selected window. The 
command line is an english-like sentence, with the 
selectable options enclosed in boxes, as follows: 

[Move] text by [Block] 


The cursor is in the box currently selected, and may be 
moved to another box using the horizontal arrows (left arrow 
for moving to the left, right arrow for moving to the 
right). The options within a box are selected by using the 
up/down arrow keys to scroll backwards or forwards. In this 
way, the desired options may be set up. For the example, 
alternative sentences (or command selections) might be 

[Move] text by [Column] 
or 

[Wipe] text by (Block ] 

and so on. The operation of the command selection procedure 
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In the remainder of this Reference manual, a shorthand 
form of representing command line options will be adopted, 
viz. 

[Move] text by [Block ] 

[Copy] [Column] 

[Wipe] 

The Command line arrangement is thus orthogonal (i.e. 
option groups are independently settable), and the number of 
instructions selectable is the product of the options in 
each group. In this example, there are 3x2 = 6 distinct 
and separate instructions. 

A command line is accepted by pressing the RETURN key. 
The next time a command line is accessed, it will (with few 
exceptions) show the options selected at its last 
invocation. Thus, on successive calls, it is only necessary 
to modify those options which must be changed. 

Within some command lines, it is legal to enter text 
into the boxes, such as for selecting the size of paragraph 
indentations, line width, and so on. Where a box will 

accept text, the first character in the box is underlined, 
as follows: 

Line :: Para Indent[!5 ] Line Indent[5 ] Line Width[72 ] 

Within a command line, the arrow keys are used for command 
option selection. When characters are being entered in a 
command line, the left arrow key acts as a destructive 
backspace during this operation. After the entered text is 
accepted by pressing the RETURN key once, it is again 
possible to perform normal command option selection using 
the arrow keys. Where numeric entry is legal, the entered 
text is checked on acceptance of the command line. If an 
error is detected, as much of the word 'ERR' as will fit 
w ill be displayed in the offending box, and re-entry of the 
text will now be possible. In some command lines, it is 
legal to both enter text and to point at command options 
within the same box group. 

A third type of Command Line, exclusively for the entry 
of character strings, may be recognized by a wide, blank 
box, with no character underlining. Examples are: 


User Interface 



252 


Part 3 - Reference 


Prnt[ 

1 

Load! 

1 

Ft 

] 

Rt 

3 


which are used for the entry of file pathnames, or text 
strings for Find/Replace/Verify operations, or for setting 
User Definable Keys. To enter the NEW LINE code into a Text 
Command Line, press Closed Apple RETURN. This distinguishes 
between acceptance of the command line, and the entry of the 
New Line character. 

With the exception of text entry boxes, the Command 
Line recognizes only the arrow keys, RETURN, and ESCAPE. 
The pressing of any other key wi'll cause the bell to sound, 
and the keystroke will be ignored. The single exception to 
this is the ability to control some printer functions from 
within a command line (see Section 13 on the Printer). 

A command line may be exited in most cases, without 
altering any options, by pressing the ESCAPE key. An 
exception to this is when no document has been selected, as 
there is no current document to escape to. This occurs on 
booting, or after clearing the current document. Another 
exception is when an attempt is made to escape to a locked 
document. 

For some functions, such as document formatting, a 
succession of command lines are presented, each of which 
presents a separate group of command options. In cases like 
this, the command lines presented will depend on the options 
set in previous command lines. For example, there is no 
need for page numbering information, if one has opted not to 
number the pages. Thus, one is not asked for information 
which will not be used. For other command lines, not all of 
the option permutations will be meaningful. In such cases 
the irrelevant information will be ignored. For example, in 
loading files, the provision of backup is irrelevant, but it 
is quite relevant to the saving of files. 

With the Command Line arrangement, illegal or undefined 
commands can never be selected. The selected options are 
always checked for compatibility and freedom from error, 
before being implemented. 
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4.0 MEMORY ORGANIZATION 

4.1 General 


Stemwriter // requires an Apple //e with the extended 
80 column card, or an Apple //c, to operate correctly. The 
Auxiliary Memory is configured as a RAM-Disk, with the 
Volume Name /RAM. The Stemwriter program consists of a 
large main program containing the editor and file management 
kernel, and four 2k byte program overlays, which contain 
some of the extended features such as formatting, printing, 
etc. Refer to Section 4.6 for full details. 

The Stemwriter // work-space is fully memory-resident, 
with the Ram-disk used as a virtual demand-paged memory. 
Thus, documents must be fully loaded into memory before they 
can be operated on. The maximum space available for text is 
approximately 51k bytes, falling to 42k bytes when the 
overlays are resident in the RAM-Disk. Thus, Stemwriter // 
can handle documents of 15 to 20 single-spaced pages in 
size. The advantages of memory-based operation are: 

(1) Rapid response. 

(2) One is always working on a copy of the filed 
document. Thus, it is possible to create 
modified versions of a document, and leave the 
original intact. On some disk-based systems, 
this is not possible. 

(3) Operation in a single disk environment is 
possible and convenient. 

Offsetting the advantages of memory based operation, is the 
restriction on document size. Therefore, Stemwriter 
includes features to minimize any problems this may cause. 

4.2 Document Arrangement 

Up to eight separate and distinct documents may be co¬ 
resident in memory at any one time. Each document has its 
own tab settings, and line/page break settings. Memory is 
allocated dynamically to each document from a central memory 
pool, according to need. When a document is deleted, or 
reduced in size, the memory it occupied is returned to the 
memory pool, for later re-allocation. This operation is 
overseen by an internal memory manager, working in 
conjunction with ProDOS. 
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Each document consists of a series of memory blocks 
forming a bi-directional linked list, to give a logically 
contiguous memory space overlaid on the physical memory 
space. The physical memory space is organized as a demand- 
paged virtual memory, using the auxiliary memory of the 
computer as a RAM disk. This arrangement ensures that, 
although Stemwriter is a character oriented editor, it has 
the operating speed of a line oriented editor with the 
memory utilization efficiency of a character oriented 
editor. For example, the execution time of block move or 
wipe operations is substantially constant, and independent 
of document size, etc. Further, transfer of text between 
documents is as easy as transfer within a document. 

4.3 Garbage Collection 

Various word processing operations may result in 
incomplete packing of some of the memory blocks. This is 
rectified by the internal garbage collector, which is active 
while Stemwriter is waiting for keyboard input. During this 
time, it scans the allocated blocks, re-packing where- it 
can, and releasing empty blocks back to the central memory 
pool. Thus, any memory packing inefficiencies are rapidly 
removed, in a totally invisible way. Should a process, such 
as a Column Move, so fragment the memory that re-packing is 
necessary before the operation can continue, the Garbage 
Collector is woken up, the memory is re-packed, and the 
original process is resumed. 

4.4 When The Memory Is Full 


When the memory limit is approached, the warning: 

Memory almost full::FINISH OP NOW 

is given for each of the last 256 characters entered. If 
these warnings are ignored, the program will refuse to 
accept further input, and displays the message: 

Memory full:must save to disk 

At this point, it is necessary either to clear one or 
more documents from memory, or to save the current document 
to disk as a file. However, it is possible to end the 
document at a convenient place, without losing the extra 
text entered. Enough memory has been retained to permit the 
opening of a new document, and the movement of the tail of a 
large document to this new document. Thus, one can break a 
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large document at a convenient place, save the head portion 
to disk, delete it from memory, and then continue adding to 
the tail portion. 

4.5 Handling Extra-Large Documents 

The preferred procedure is to save a large document in 
several files, where the end of each file corresponds to a 
natural page break. 

Alternatively, it is possible to handle text files too 
large to fit into the computer's memory, by the following 
artifice: 

When the memory initially fills, save the large 
document as a segmented file, where a page is defined as a 
segment. If no page breaks have been forced within the 
document, it will be saved as one large segment, with a New 
Page symbol inserted as the first character. Subsequent 
pieces of the large document can be added to the original 
segmented file, as large 'pages', until the entire document 
is complete. By this means, documents up to 16 megabytes in 
size can theoretically be handled. For editing, the 'pages' 
can be accessed as sequential segments, and added to a new 
segmented file, after editing. The use of the Save with 
Backup option will prevent accidental over-writing of the 
original file. When it comes time to format the document, 
one would need to format from file to file, with Page 
Preview. Under these circumstances, the Formatter treats a 
segmented file as though it were a whole file. The page 
break directives saved in the file are discarded (N.B. page 
break directives saved as part of a whole file are not 
discarded). Any required page breaks may be inserted into 
the text contained in the source file scratchpad, as each 
page is formatted. 

4.6 System Overlays 

Because of the hardware organization of the memory of 
the Apple //e and Apple //c, not all of the Stemwriter 
program can reside in main memory at the same time. The 
Stemwriter program is therefore organized as a large main 
kernel containing the editor, and file load/save operations, 
with four 2k byte overlays for the extra features. When an 
overlay-resident task is requested, the task code must be 
loaded to the overlaid area of the main memory before the 
task can be executed. 


Memory Organization 



256 


Part 3 - Reference 


The overlays are stored in files, and are initially 
provided on the boot diskette. Using the Utilities program, 
one may define whether the overlays, when required, are 
drawn from a nominated disk volume, or from the Auxiliary 
Memory bank of the computer. In this latter case, the 
overlay files are copied to the Auxiliary Memory during 
boot-up, as RAM-disk files. This of necessity reduces the 
available workspace for the virtual memory by about 8k bytes 
compared with disk-based operation, but provides for 
efficient fully memory-based operation. 


Overlay organization is as follows: 


Overlay Number 

File Name 

Contents 

0 

STM.00 

Form Letter, Line & 
Column Alignmemt 

1 

STM.01 

Abstract Printer 

2 

STM.02 

File operations (Open 
Apple 7) 

3 

STM.03 

Formatting 


During boot-up. Overlay 0 is loaded, and flagged as 
active. Thus, Stemwriter // has its full editing capability 
initially available without recourse to overlaying. 
Operation with the overlays in the RAM-Disk permits 
efficient single disk drive operation. When the additional 
8k bytes of memory is critical, the overlays may be drawn 
from diskette as required. The overlaying procedure will 
signal if a required overlay is not available, and give an 
opportunity for the overlay disk to be inserted in a drive. 
As the commands relegated to overlays are less often used 
than the editor, overlay accesses are relatively infrequent. 
Thus, quite extensive editing can conveniently be carried 
out in a single-disk environment, even when the overlays are 
to be drawn from a diskette. 
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5.0 SCREEN MANAGEMENT 

The standard Stemwriter screen size is 80 characters by 
22 lines, with one line being used as a Command Line. 
Double High Resolution Graphics is used to implement the 
screen display, with each character being represented by a 7 
by 9 matrix of dots. The extra row of dots for each 
character compared with the text screen, allows for on¬ 
screen underlining. Bold printing is represented by inverse 
video. The usage of the graphics page allows for the true 
representation of superscripting, subscripting, and 
character overstrike on-screen. None of these facilities 
would have been possible had the text screen been used. 

Vertical scrolling in both forward and reverse 
direction in one line increments is implemented. Horizontal 
scrolling is implemented in 40 column increments, for the 
entry of wide lines (up to 240 characters), such as for wide 
tables of figures. On text entry, when the 81st character 
is reached, the screen is repainted to show the text in 
column positions from 41 to 120. With further scrolling, 
the text column at the left of the screen progressively 
becomes 81, 121, and so on. The screen is thus moved like a 
window over the text page, always enclosing the current 
cursor position. 

5.1 Split Screens 

Stemwriter permits the selection of three screen 
windows for viewing the document. These are: 

Window A The entire Screen (Cotmand line at the top) 

Window B The upper half-screen (Cotmand line at the tcp) 

Window C The lower half-screen (Cotmand line centre-screen) 

It is thus possible to display parts of two separate 
documents or different parts of the same document 
simultaneously. This is particularly useful for viewing 
text transfers between documents, for being able to view one 
part of a document for reference while editing another part, 
or for comparing unformatted and formatted versions of the 
same document. 

5.2 Movement Over Text 


The Cursor may be moved over the text by line, 
character, word, and paragraph in both the forwards and 
reverse directions. It is also possible to move directly to 
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the Document Head or Tail, or to a defined word or character 
string (See the Find/Replace/Verify command. Section 10.0). 

5.2.1 Jump (Closed Apple 8) 

Pressing Closed Apple 8, initiates the Jump command: 

Jump to Doc. [Head] 

[Tail] 

This is a rapid method of moving the cursor from the current 
position to the Head or the Tail of a document. 

5.2.2 The Arrow keys 


The four arrow keys control movement of the cursor over 
the text as follows: 


Up Arrow 

- Back-up 

one 

line 

Down Arrow 

- Advance 

one 

line 

Left Arrow 

- Back-up 

one 

character 

Right Arrow 

- Advance 

one 

character 

Open Apple-Left Arrow 

- Back-up 

one 

word 

Open Apple-Right Arrow 

- Advance 

one 

word 


5.2.3 New Line (RETURN, Open Apple RETURN) 

Pressing Open Apple RETURN moves the cursor to the head 
of the current line. Each subsequent press of Open Apple 
RETURN moves the cursor to the head of the previous line. 

The operation of the RETURN key depends upon where the 
cursor happens to be in the text. Pressing the RETURN key 
when it is in the body of the text, moves the cursor to the 
head of the next line. If the cursor is at the end of the 
document, pressing the RETURN key will create an unambiguous 
New Line, which is unaltered by formatting or remargining. 

5.2.4 Paragraph Selection (Closed and Open Apple 1) 

This key functions in a similar manner to the RETURN 
key, as follows: 

Pressing Open Apple 1 moves the cursor to the head of 
the current paragraph. Subsequent to this, each press of 
Open Apple 1 will move the cursor to the head of the 
previous paragraph in the document. 
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Closed Apple 1 has a dual function. If the cursor is 
at the tail of a document, pressing Closed Apple 1 creates a 
new paragraph, complete with specified paragraph indent. If 
the cursor is in the body of the document, however, pressing 
Closed Apple 1 moves the cursor to the head of the next 
paragraph. 

5.3 Rubout (Delete Key) 

The RUBOUT function removes characters, one at a time, 
from the screen. Each time the Delete key is pressed, the 
character beneath the cursor is removed. RUBOUT will not 
remove field markers, new line or new page characters. It 
does remove superscripts and subscripts. There is no re¬ 
calculation of line breaks associated with this key. To 
force re-margining after RUBOUT, cut and paste the text 
(press Closed Apple 0 twice). 

5.4 New Page (Closed Apple 3) 

Pressing the New Page key (Closed Apple 3) forces a new 
page, identified in the text by an Open Apple character. 
The new page character is inserted at the current cursor 
location. 

5.5 Repaint (Closed Apple =) 

Pressing this key simply refreshes the screen display. 
The cursor is positioned at the centre of the current window 
when both the cursor position and the first line of the 
document cannot fit in the chosen window. 

5.6 Cut/Paste (Closed Apple 0) 

The cut operation permits the insertion of text within 
a document. When Closed Apple 0 is pressed, the document is 
cut at the current cursor location, and all text following 
this point is placed in a temporary document. This is 
accompanied by the following message in the command line: 

Text Cut 

At this point, the cursor is positioned at the tail of the 
truncated document. All editing features are available for 
the manipulation of the text being added. To re-join the 
saved tail of the original document, press Closed Apple 0 a 
second time. The message 
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Text Rejoined 

appears in the command line and the saved tail is appended 
to the augmented document. Any necessary re-margining is 
also carried out. To summarise, pressing Closed Apple 0 
once CUTS the text and pressing Closed Apple 0 a second 
time, PASTES the text. 

When moving the cursor to a new document, or when 
saving a document as a disk file, a CUT document is 
automatically re-pasted by the Stemwriter program, before 
the operation is executed. 

5.7 Super And Subscripting (Open Apple Up, Down Arrows) 

Super and subscripting are effected by pressing the 
Open Apple key with the up arrow key and the down arrow key 
respectively. Up to 4 levels of superscripting and 4 levels 
of subscripting are allowed. During text entry, the number 
of super and subscripts is balanced at the end of a line. 
This balance may not remain after the cut/paste, and single 
character rubout commands have been used. It is the 
responsibility of the user to ensure that no imbalance 
results in these cases. 

Printers which use half-height characters to produce 
super and subscripting may only give one level of super¬ 
scripting or subscripting, even though multiple levels were 
specified. No such restriction applies for printers with 
both forward and reverse half-line feed capability. 

5.8 Overstrike 


Pressing Open Apple with the ESCAPE key embeds a 
backspace command in the text, thus allowing for the 
creation of on-screen overstriking of characters. This is 
useful for creating the not equals and so on. 

5.9 Entering The Date 

The date is entered once only, when the system is first 
booted. The Date Command Line is: 

Today's Date :: Dayt26] Monthtl ] Year[l 1 984] 

Legal dates are from 1st January 1983 to 31st December 
1999. The legality of the entered date is checked, and the 
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error message: 

Illegal Date <Cont. on SPACE bar> 

is given if an error is made. Pressing the SPACE bar 
restores the Date Command Line, and one cannot continue 
until a legal date is entered. (Stemwriter knows all about 
leap years). The year must be entered in full. 

5.10 Previewing Formatted Document 

During the formatting of a document, it is optionally 
possible to preview the formatted text, one page at a time. 
During Page Preview, the user is (except for the Find/ 
Replace/Verify operation) prevented from operating on the 
formatted text. The cursor may be moved over the text using 
the arrow keys in the usual way, but there is no exact 
registration between the cursor position and the character 
currently referenced. This is because the space and micro¬ 
space compression codes are correctly interpreted in 
generating the display, but are not always correctly 
interpreted by the character and word movement operations. 
Line moves (up and down arrow) will register the correct 
line. To obtain exact registration of cursor with current 
character, repaint the screen by pressing Closed Apple =. 
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6.0 USER DEFINABLE KEYS (Open Apple =) 

When the keys A to J are pressed in conjunction with 
the Closed Apple key, they provide 10 User Definable keys. 
Each key can be programmed to represent up to 31 keystrokes, 
which, with few exceptions, are executed as though they had 
been typed at the keyboard. System keys, standard character 
keys, or other User Definable Keys are legal entries in the 
definition of a User Definable key. 

The User Definable Keys may be concatenated (chained 
together) in any order by including other User Definable 
Keys as the last character of the defined character string. 
In this way, up to 300 characters of text may be entered 
with a single keystroke. 

Initial settings of keys A to J may be defined using 
the Stemwriter Utilities program. User Key D is defined on 
startup with the current date, in the format: 

January 29, 1985. 

When a User Definable key contains another User 
Definable key as part of its definition, it passes control 
permanently to that key at that point, and all following 
characters in the definition of the original User Definable 
key are ignored. When User Defineble Keys contain system 
keys as part of their definition, any command lines 
associated with that system key has its options selectable 
from the keyboard in the usual way, as is acceptance of the 
command line itself. 

Because the User Keys can call each other in their 
definition, it is possible to set up infinite chaining. For 
gxample. User Key A may chain to User Key B, which in turn 
chains back to User Key A. When this happens, the pressing 
of the User Key A will initiate a sequence of events which 
will not terminate until the memory is completely filled 
with repeated calls to Keys A, and B. If this happens, the 
currently active User Key may be terminated by pressing 
Control-Q. 

To set a User Definable Key, press Open Apple =. The 
available permutations of the command line are as follows: 
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Set User Key [A] 

IB] 

[Cl 

[D] 

[E] 

[F] 

[G] 

[ H] 

[I] 

[J] 

When the User Key to be set is chosen, the next command 
line is: 

[AH ] 

The letter in the first box is the letter of the key 
being set. It cannot be altered at this stage. The 
character string required must be entered, and accepted with 
RETURN. Because the RETURN key acts as both a New Line key, 
and an ENTER key, one must specify NEW LINE selection in a 
Command Line by pressing Closed Apple RETURN. 

User Definable Keys are great for providing a rapid way 
of entering frequently used character sequences, words, or 
phrases. 
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7.0 WINDOW AND DOCUMENT SELECTION 

This group of commands permits the selection of viewing 
window, the creation of, and movement between, documents, 
and the setting of the global printing and line break 
environment associated with a document. The keys involved 
are: 


Closed Apple 9. 
Open Apple DELETE. 
Open Apple 9. 


7.1 Selecting The Document And Window 


On 

pressing Closed 

Apple 9, the command line 

Display 

:: Window!A] : 

Document!1] 

!B] 

! 2 ] 


[C] 

!3] 



!41 



!5] 



t 6 ] 



[7] 



!8] 


appears. Each document is given a number between 1 and 8. 
If the selected document had previously been opened, the 
document is re-displayed in the selected window, with the 
cursor at the position it last occupied when the document 
was exited. Escape from this command line is possible only 
if a document exists to escape to. For a new document, the 
line and paragraph information is requested: 

Line: Para Indent! J5] Line IndenttO ] Line Width!22 1 

If the default paragraph indent, line indent, or line width 
values are unacceptable, the new values must be typed in 
(Note the underlining of the first character in each box, 
signifying text entry). Escape from this command line at 
this point is not possible, because a commitment has been 
made to create a new document. The detailed operation of 
this Command Line is discussed in Section 7.3. 
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7.2 Clear Document (Open Apple DELETE) 

Pressing Open Apple Delete, displays the command line: 

Clear Document [1] 

[ 2 ] 

(31 

[4] 

[5] 

[ 6 ] 

(7] 

[ 8 ] 

Execution of this command releases the memory 
previously occupied by the document back to the central 
pool, whence it is re-allocated to other documents as 
required. If the document cleared happens to be the 
currently active document, then the document selection 
process is initiated, as though Closed Apple 9 had been 
pressed. 

For protection, it is not possible to delete a locked 
document. For example, it is not possible to delete any 
documents during the formatting process, or a document 
currently being printed. 

7.3 Set Line/Paqe Breaks (Open Apple 9) 

Pressing Open Apple 9 displays the command line: 

Set Global data for [Line] break calculation 

[Page] 

Selection of the [Line] option displays the further command 
line 


Line: Para Indent[5 ] Line IndenttO ] Line Width[22 ] 

The Line Indent and Paragraph Indent provide an 
efficient way to create indented text. Whenever a 
conditional line break occurs, the number of character 
spaces specified as Line Indent are inserted at the head of 
the line, effectively indenting the text. Following a New 
Paragraph command, the line is indented the number of spaces 
defined as the Paragraph Indent. After an unambiguous New 
Line command (RETURN), the following line starts at the left 
margin, and is not indented. Both the paragraph and line 
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indentation characters form part of the line width character 
count. 

"Hanging Indented" paragraphs, such as required for a 
Reference List, can be created by setting a Paragraph Indent 
of 0, and a Line Indent, say, of 5. Each Reference would 
then be entered as a new paragraph. 

"Bulleted" or indented paragraphs may be entered by 
setting the Line and Paragraph Indent to the same non-zero 
value. 

By judicious use of Local Fields, a mixture of indented 
and non-indented text may be conveniently created within the 
one document. 

When the new line width, line indentation, and 
paragraph indentation are selected and accepted, the 
currently active document is re-margined in accordance with 
the new information. The screen will be blank while re¬ 
margining occurs. 

Selection of the [Page] option permits the selection of page 
break and printing options. These are set to default values 
when the Document is created, and are used by the printer 
for controlling printing. This information is also settable 
by passage through the Formatter and can be optionally 
changed at print-out time. The next command line displayed 
is: 

Page: LeftllO] Head[3 ] Foot[3 ] Margins on Sheet[A][Norm] Font[12] StylelA] 


[ B][Rot. ] 

[10] 

[B] 

[C] 

[PS] 

[C] 

[D] 

[15] 

[D] 


The left margin specifies where printing will start on 

the page, in units of the selected character size (font). 
The Head and Foot margins specify the number of single lines 
left clear at the top and bottom of the page. The 
Stemwriter Utilities program allows for the presetting of 
four standard page sizes to correspond to the letters A,B,C, 
D. [Norm] and [Rot.] specify whether the page is inserted 
normally, or turned on its side. Any of four fonts, 15,12, 
10 characters per inch, and proportional spacing may be 
selected. Four font styles may also be assigned to the 
letters A,B,C,D by the Utilities program. Examples of font 
style are Italic, Cubic, Prestige Elite, Courier. The 
information on sheet size, paper orientation, font, and font 
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style is used to ensure the correct directives are sent to 
the printer. ( See Section 13 on the printer for more 
information). When this command line is accepted, further 
information is set by the command line 


Line Space[l ] 

at[6] Line/Inch Paper Feed[Sing] 

Print ColortA] 

[1.5] 

[8] [Cut ] 

[B] 

[2 ] 

[Cont] 

[C] 

[3 ] 


[D] 


This information allows the setting of line spacing, lines 
per inch, paper feed mode, and print ribbon color. For 
further information, refer to the Section 13 on the Printer. 

When this Command Line is accepted, the cursor is 
returned to the currently active document. The ESCAPE key 
can be used at any stage, for both [Line] and [Page] 
options, to terminate option selection and have the original 
options unaltered. 

These options, or their default initial values are 
permanently associated with the document, and are saved to 
disk with the document, and restored when the document is 
loaded from a disk file back to memory. 
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8.0 TAB CONTROL (TAB, Open Apple TAB, Closed Apple 5) 

Stemwriter associates 16 independently settable tab 
stops with each document. The tab settings are saved with a 
document, and restored when the document is re-loaded. A 
tab alignment character may be associated with each tab 
stop, to give generalised column alignment capability to the 
Stemwriter program. For example, specifying a decimal point 
Tab alignment character will permit the decimal alignment of 
a column of figures. Similarly, the equals sign may be used 
to align equations, and the left bracket might be used to 
align equation numbers. 

Manipulation of the tab settings is initiated by 
pressing Open Apple Tab, to show the command line: 

(Set ] Tabs 
[Clear] 

[S how ] 

8.1 Clearing Tabs 

Selecting the [clear] option produces the command line 

Clear [all ] Tab from Col [Csr ] 

[1 1 [1 ] 

Some or all tabs may be cleared, starting from a 
specified column, or the current cursor position. 

8.2 Setting Tabs 

Selecting the [set] option displays the command line 

Set []. ] Tab at Coltl ] Step [jB ] Align. Chr [j^. ] 

[all] [Csr] 

The alignment character associated with the tab stop is used 
for column alignment operations. The space character 
indicates that no alignment character has been chosen and 
'Step' is the interval between successive tab stops. 
Setting may commence at a nominated column position, or at 
the current cursor location. Some or all of the tabs may be 
set. 


The error message 

Insufficient free tabs CCont. on SPACE bar> 
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is given and the task terminated, if an attempt is made to 
set more than 16 tabs per document. 

8.3 Showing Tabs 

Tab stops, and their associated alignment characters 
may be shown on a ruler in the command line whenever a 
message, or a command sentence is not being displayed. For 
wide lines, the current left window column value is shown at 
the left of the ruler. Tab alignment characters are shown 
in inverse video, and the null character is shown by an 
underline. The command line is: 

Tab Display [on ] 

[off] 

8.4 The Tab Key 

Within the body of a document, pressing the TAB key 
moves the cursor horizontally to the next tab or the right. 
Movement past the currently selected line width does not 
occur. At the end of the document, spaces are appended to 
permit movement to the next tab stop. 

8.5 Text Alignment (Closed Apple 5) 

Alignment of text can be implemented by pressing Closed 
Apple 5 to show the command line: 


Align text by [Line ] 

[Column] 

Selecting the [Line] option causes the prompt: 

Line Adjust :: Lteft C(enter R(ight Arrows Exit on <esc> 

to be displayed, with the cursor in the body of the 
document. Pressing L, C, or R will cause the current line 
to be left justified, centred, or right justified 
respectively. The left and right arrows cause the line to 
be moved left or right one column per keystroke. The 
up/down arrow keys may be used to repeat the selected 
adjustment in the adjacent lines. When the aligning has 
been satisfactorily completed, pressing ESCAPE will 
terminate the command. 
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Selecting the [column] operation displays the command 

line: 


Align char to [Near ] Tab 
[Left ] 

[Right] 

The character group to be moved is delimited by the 
space character on either side. When this command is 
accepted, the cursor returns to the body of the document, 
with the command line reading: 

Up, Down Arrow Repeats <esc> exits. 

The character under the cursor is matched against the 
characters associated with the tab stops. If the character 
does not match any set tab characters, the error message : 

Illegal Tab Char <Cont. on SPACE bar> 

is given, and the operation ceases. If a match is found in 
the specified direction, an attempt is made to move the 
character group containing the cursor, so that the tab 
characters are vertically aligned. The options specify 
whether alignment to the left, right, or the nearest Tab 
occurs. If this cannot be done without disturbing the rest 
of the line, the error message: 

Alignment impossible <Cont. on SPACE bar> 

is displayed. The up/down arrow keys are used to repeat the 
alignment of columns of alphanumeric characters. Thus, an 
entire column may be aligned without disturbing adjacent 
columns. If, in moving with the arrow key, the cursor falls 
outside a character group containing the chosen alignment 
character, aligning ceases with the appropriate error 
message. Re-positioning the cursor and repeating the 
alignment command will be successful, provided no collision 
between column entries occurs. The effect of using this 
command is to convert this: 
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14.64 

2.171 

217.5 

(Set- 

218 

219 

220 

tab character 

(Table in 

in Command Line) 

Document) 

this: 


(Set 

tab character 

in Command Line) 

14.61 

218 



2.171 

219 



217.5 

220 
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9.0 BLOCK/COLUMN OPERATIONS (Open and Closed Apple 2) 

Stemwriter supports both block and column operations on 
text. The general procedure is to select the required 
operation, mark the bounds of the text affected, move the 
cursor to the destination position for Copy/Move, and 
complete the operation. 

Block and column operations are initiated by pressing 
Open Apple 2 to show the command line: 

(Copy] text by [Block ] 

[Move] [Column] 

[Wipe] 

When the Copy option is selected, the command line then 
shows 


[Copy] text by [Block ] :: Move cursor to marker #1 and set 

The selected option is shown as a reminder. To set the 
first marker (delimiting one bound of the text to be 
operated on) press Closed Apple 2, once. The command line 
then shows: 


Marker #1 now 

set 

:: Move cursor to marker #2 and set 

The second marker is set by pressing Closed Apple 2, a 

second time. 

The 

command line then becomes: 

Marker #2 now 
(copy/move) 

set 

:: Move cursor to Copy/Move destination 

or 

Marker #2 now 
(wipe) 

set 

:: Ready to delete marked text 


9.1 Marker Positioning 


The markers setting the bounds of the text affected may 
be set in any order. Stemwriter will re-order them before 
executing the command. For [block ] operations, all the 
text between the markers is affected. For [column] 
operations, the markers are set in the diagonal corners of 
the column of interest, i.e. either the upper left and lower 
right, or the upper right and lower left corners. The 
markers must be in the same document, or an error will 
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result: 


Marks not in same Doc. <Cont. on SPACE bar> 

Placing the destination within the bounds of the marked text 
for the Block Operations and the Column Copy Operation, 
results in the error message: 

Error in Marker Position <Cont. on SPACE bar> 

If a block is marked bounding no text, or a zero width 
column is specified, an error message is given: 

Null text field <Cont. on SPACE bar> 

For the Column Move operation, placement of the 
destination marker within the marked bounds, causes the 
marked column to be 'pulled downward' until its first entry 
is at the line containing the cursor, and one space to the 
right. If the cursor is placed on the left edge of the 
column, 'pulling down' without shifting to the right, 
occurs. For the Column Wipe operation, the destination 
cursor, if within the marked bounds, is moved to the upper 
left corner of the marked column. 

For the copy operation, the markers stay in position. 
Repeated copying can be carried out by re-positioning the 
cursor and pressing Closed Apple 2 for each additional copy 
required. 

9.2 Terminating An Operation 

From the initial Copy/Move/Wipe command line, it is 
simply a matter of pressing ESCAPE to exit this command. 
However, when one or more markers have been set, or to 
remove copy markers when copying is complete, press Open 
Apple 2, followed by ESCAPE: 

9.3 Margin Control 

For Move/Wipe operations, re-margining of the document 
occurs at the position the text is removed from. For the 
Copy/Move operation, the destination of the Moved/Copied 
text is also re-margined, if required. Line break re¬ 
calculation commences at the first new line character prior 
to the text affected, and continues until an unconditional 
line break is reached. Paragraph indents are not re¬ 
calculated. Thus, in some cases, such as when moving large 
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portions of text from one document to another with different 
margins, it may be necessary to globally re-margin the 
document receiving the text. No margin checking occurs for 
column operations. 

9.4 Unwipe 

For the block wipe command, the command line will show 
the message: 

<esc> will unwipe 


While this message is displayed, pressing ESCAPE will 
restore the text just wiped. The message will disappear 
when any key other than ESCAPE is pressed, and the removed 
text will then be gone forever. 

9.5 Memory Usage and Column Operations 

Column Move and Copy operations require a lot of 
internal cutting and pasting, which tends to temporarily 
fragment the memory. Therefore, if, during a Column 
Copy/Move, there is temporary memory overflow, the Garbage 
Collector is woken up, and set to re-packing the memory. 
This process adds about 30 seconds to the time otherwise 
needed to perform the Column operation. 
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10.0 FIND/REPLACE/VERIFY (Open Apple 8) 

The FIND/REPLACE/VERIFY command is implemented by 
pressing Open Apple 8 to obtain the command line: 

[Find 3 designated word/string 
[Replace 3 
[Verify ] 


Irrespective of which option is selected, the next command 
line is: 


Srch:: Dir[>] 

: Count!All] 

: BoundtPara 

3 

: Case [Exact] Mode [Lit 3 

[<3 

[1 3 

[Doc. 

3 

[Any 3 [Word] 



[Chr: 

3 

[Not =] 


Reading from left to right, one may scan for a match towards 
the tail or the head of the document. The search may be for 
all or a specified number (up to 255) of matches. For FIND, 
the search stops at the specified number of matches. For 
REPLACE or VERIFY, 'Count' specifies the number of matches 
to be considered for replacement. The search may be bounded 
to the end of the current paragraph, to the end of the 
document or until a specified character is reached. If less 
than the specified number of matchings is found, the 
message: 

Not all matches found CCont. on SPACE bar> 


is displayed. The Stemwriter program will search for the 
exact case, any case, or a case mis-match. The character 
string searched for may be literal, and form part or all of 
another word or several words, or it must be an entire word. 
The word search option recognizes punctuation and spaces as 
word delimiters. 


The next command line shown is: 



and requires the entry of the character string to be 
matched. If the 'Word' search option is selected, the 
following wildcard searches are possible: 
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Prefix un~ 
Suffix ~ing 

Word Body ~and~ 


will find all words with the prefix 
'un', e.g. unsteady, unhappy, uncle, 
etc. 

will find all words with the suffix 
'ing', e.g. running, jumping, crying, 
etc. 

will find sandal, brands, handle, etc. 


The Replace and Verify commands for wildcard searches, 
simply replace the matching word fragment. For example, 
searching with '~ing' and replacement string 'ed' would 
result in 'happening' becoming 'happened', and so on. If 
the Find option is selected, then Stemwriter does not 
execute the command. For Replace and Verify the further 
command line: 


R[ 

] 

or 


v[ 

] 


is displayed, for the entry of the text to be used to 
replace the searched for text. (Remember, Closed Apple 
RETURN permits placement of the New Line Character within 
the Text string entered.) For the Replace option, 
Stemwriter replaces character strings as it matches them 
until all are done, or the bound of the search is reached. 
For the Verify option, Stemwriter halts as each match is 
found, and asks: 

Replace the Match <esc>/Y/N: 

Pressing ESCAPE terminates the Verify operation. Pressing Y 
causes the matched text to be replaced before moving to the 
next match, and pressing N allows movement to the next match 
without replacement. This continues, until the specified 
number of matches is made, or the bound of the search is 
reached. 


Whenever a replacement is made, the line involved, and 
the following text is automatically re-margined until an 
unconditional line break is reached. 
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11.0 FILE MANAGEMENT (Closed Apple 7) 

Stemwriter // operates under ProDOS, and produces files 
which are fully interchangeable with files produced by 
Stemwriter ///, under SOS. That is, both the disk formats, 
and the internal file structures are identical. 

Stemwriter supports two types of text files for the 
storage of documents, viz: whole files and segmented files. 
A standardised set of embedded control codes apply to all 
files created by Stemwriter, and are shown in Tables 12.1 
and 12.2. In particular, the same standard space 
compression scheme used for Apple /// Pascal text files, is 
employed. The first two blocks of a file are used to save 
formatting and status information, and the text itself 
starts in the third block. 

11.1 Whole Files 


A whole file is a text file, organized along similar 
lines to an Apple /// Pascal text file. Stemwriter files 
differ from Pascal files in that they permit lines to cross 
file block boundaries, and use the space compression scheme 
within the body of lines, as well as at line heads. This 
results in slightly smaller files. It also means that 
Stemwriter Files should be run through the Stemwriter 
Utilities program, 'Vanilla', before being presented to a 
Compiler, Assembler, or an alternative Editor. 

11.2 Segmented Files 

A segmented file is internally identical to a whole 
file in structure. However, the file header information 
contains the name of a Segment Table file (of type Data), 
called SEGTBLnnnn, where nnnn is an identifier number 
allocated by Stemwriter when the file, is created. The 
Segment Table contains a table of start and end markers for 
chunks of text within the file. A segment is accessed by 
using its identifying number to obtain its start and end 
markers from the Segment Table. This information is then 
used to fetch the desired section of text from the body of 
the Segmented File. 

Thus, a segmented file is a random access file, with 
variable size and format, densely packed records. 
Typically, a segment within a segmented file will correspond 
to a paragraph, or a page. The Formatter saves a document 
as a segmented file, where each page corresponds to a 


File Management 



278 


Part 3 - Reference 


segment. The printer is then able to print the formatted 
pages from the file in toto, or in part, and in any order. 
A second example of a segmented file would be a boilerplate 
file of standard library paragraphs, such as required for 
tender specifications, or legal documents. The desired 
paragraphs can be fetched from the library file in the 
required order to build up the new document. Further 
examples of segmented file usage would be for maintaining a 
bibliography, or an address list. 

Operations on Segmented Files include Sorting, 
Selecting, Copying, Deletion, and the appending of new 
segment records. 

11.3 Building File Pathnames 

File pathnames provide a 'path' through the various 
directory and subdirectory levels to the desired file, and 
are entered in a character entry command line such as: 

Path ( ) 

As for the standard command lines, the arrow keys may 
be used to 'see and recognize' a file pathname. Starting 
with a blank command line, pressing the down arrow key will 
cause the volume name of the diskette in the 'boot' drive to 
be displayed. Further pressing of the down arrow key will 
scroll through the volumes on line. The up-arrow key will 
permit scrolling in the reverse direction. When the desired 
volume is shown e.g. 

Path[/BOOTDISK ] 

pressing the right-arrow key will cause the first entry in 
the volume directory to be displayed. Again, the up and 
down arrows provide for bi-directional scanning through the 
names in the volume directory. At the end of this phase, 
the display might be: 

Patht/BOOTDISK/SUBDIR ] 

Pressing the right arrow key once more will open the 
subdirectory SUBDIR, and its entries may once again be 
scrolled through with the up, down arrow keys. This 
procedure may be repeated till the full pathname is built 
up: 

Patht/BOOTDXSK/SUBDIR/MYFXLE ] 
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If an attempt is made to extend through a non-directory 
file, the error messages 

Sterile Pathway <Cont. on SPACE bar> 

results. Pressing the space bar will re-display the path 
command line, with as much of the pathname retained as is 
legal. 

All or part of the pathname may also be typed in 

directly, as well. This is appropriate for entering the 

actual file name for a new file after building up its 

directory and subdirectories. The left arrow acts as a 
destructive backspace. 

Unlike SOS, ProDOS does not recognize pathnames starting 
with a device name, such as .Dl, or .PROFILE. The use of a 
device name will produce an error. 

When a file pathname is accepted, and the desired 

operation completed, the directory and subdirectory levels 
are retained, and the next reference to a pathname will 
start with the last used directory and subdirectory levels 
displayed. Note that subdirectories must be created before 
they can be used . 

File pathnames are required in many places, and all 
obey the above rules. 

11.4 Segment Selection 

The segments to be loaded to a document, or printed, 
are selected by the text entry command lines 


Load Segment! 

] 

Prnt Segment! 

] 


The general form of a segment entry component is: 


low number..high number:repeat!step] 

-a component- 

Up to 12 components may be selected within the one 
command line, the components being delimited by commas. Low 
to high number specifies the range of segments to be 
considered, step is the increment between successive 
segments in this range, and repeat is the number of times 
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the whole thing is repeated. For example, 1..5:2[2] results 
in the selection of 1,3,5,1,3,5. The letter 'E' or 'e' may 
be used to designate the last segment in the segment file. 
Examples of legal entries are: 


Short Form 

Full Representation 

Segments Selected 

5 

5.. 5:1 [ 1 ] 

5 

5:2 

5.. 5: 2 11 ] 

5,5 

5..7 

5..7:1(1] 

5,6,7 

5 .. 11[3] 

5..11:1(3] 

5,8,11 

5..7:2 

5..7:2(1] 

5,6,7,5,6,7 

1. .E 

1..E:l[l] 

All Segments 

1. . E[2 ] 

1. . E: 1 [ 2 ] 

All Odd Segments 

2. .E[2] 

2. . E: 1 ( 2 ] 

All Even Segments 


A command line may consist of any mixture of short form and 
full representation components. The command line 

Prnt Segments 11,2,3:2,5..9,11..17[2 ] 1 

is perfectly legal, and will be processed reading from left 
to right. 

The error message 

Entry error at underline CCont on SPACE bar> 

is displayed if an attempt is made to enter a thirteenth 
component, or if a syntax error is detected. Pressing the 
SPACE bar re-displays the command line, with the position of 
the first error detected being underlined. The error may be 
corrected by backspacing to the error point, and retyping. 
If an attempt is made to access segments which do not exist, 
Stemwriter does what it can, and displays the message : 

Not all segments exist <Cont. on SPACE bar> 

when it is done. 

11.5 File Encryption 

To protect sensitive documents, a password and data 
encryption facility is provided. The password must be given 
for all operations involving encrypted files, via the 
command line: 
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Password! ] 


The password may consist of any keystrokes, excluding those 
on the numeric keypad. To produce an invisible password, 
the 'CONTROL' key may be held depressed whilst typing the 
password. However, to be accepted, a password must match 
EXACTLY the one given at file creation. If the wrong 
password is given, the task is terminated, with the 
displayed message: 

Sorry- wrong password <Cont. on SPACE bar> 


The password provides a second level of protection, as 
it becomes an encryption key used to encode the data in the 
file. Thus, encrypted files, if accessed by programs other 
than Stemwriter, will return indecipherable gibberish. 
Sensitive text is thus always incomprehensible unless the 
correct password is known. It is thus vitally important to 
remember the password given, and to keep it secure. 

11.6 Backing Up Files 

When updating drafts of a document, it is often 
necessary to be able to refer to a previous draft version. 
Stemwriter provides a selectable facility which 
automatically preserves the previous version of a file. It 
works like this: when a file path name already exists, it 
is modified by appending the suffix .BAR to create the 
backup pathname. Any file with the backup name is deleted, 
the existing file is renamed with the backup name, and a new 
file is created for the latest version of the document. 
This sequence of events ensures efficient usage of disk 
space, which is particularly important on limited capacity 
floppy disks. Further, there is always a valid version of 
the document on file. 

11.7 Loading Of Files 

Files are loaded into the currently active document, 
and the text in the file is inserted at the current cursor 
location. That is, the document is cut, the text in the 
file is loaded, and the document is repasted. When loading 
to a new document, the file statistics replace the selected 
document environment. If the host document already contains 
text, then the environment of the host document prevails. 
Text loaded from a file is not remargined, but is loaded 'as 
is'. If re-margining is required, the key Open-Apple 9, 
with the [line] break option should be selected, and 
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executed. 

It is not possible to load the text in a file into a 
Special Field unless the Field Markers are turned off. An 
attempt to do this will result in the display of the error 
message: 

Sorry - Special Field 

As a protective mechanism, the Load/Save command line 
always appears with the [Load] option displayed. 

11.8 File Load/Save Command Line (Closed Apple 7) 

We are at last in a position to consider the file 
manipulation command lines. Pressing Closed Apple 7 shows 
the load/save command line: 

[Load][whole] file [with ] Encryption and [with ] Backup 
[Save][segt.] [without] [without] 

For the [load] option, only the first two boxes are 
meaningful. Backup on load is meaningless, and Stemwriter 
checks the actual file selected to decide if a Password has 
to be given. 

If the [Save][segt.] option had been selected, the 
further command line: 

[Save] [all ] [para] as Segment 
[Add ] [this] [page] 

is displayed, giving a choice of how the segments are to be 
defined (page or paragraph), whether all segments, or only 
the segment containing the cursor are affected, and whether 
the nominated segment(s) are to be saved in a new file, or 
added to an existing file. 


Depending on the options selected, the command lines 
already discussed will be displayed as needed, in the 
following order: 


Segments 

(Loading Segments 

only) 

Pathname 

(always) 


Password 

(if encryption is 

indicated) 
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11.9 File Manipulation Commands (Open Apple 7) 


Various file housekeeping facilities are provided, 
selected from the command line: 


File Operations : [Rename File 

] 

[Wipe File 

] 

[New Directory 

] 

[List Directory] 

[Volume Map 

] 


11.9.1 Renaming 

Files 


The command 

lines: 


Ren. [ 


1 

Password[ 

] 

(if encrypted) 

To [ 


] 


are displayed, in that order. Errors are flagged if the 
file selected for renaming does not exist, or if a file 
already exists with the new name. 


11.9.2 Wipe File 


This option causes the following command line to be 
displayed: 


Wipe [ 


] 

Password[ 

] 

(if encrypted) 


An error is flagged if the selected file does not exist. If 
a Segmented File is being wiped, then its associated Segment 
Table is removed also. 


11.9.3 New Directory 

The pathname of the new sub-directory is entered 
through the command line: 

New [ ] 

This command must be used to create a sub-directory, before 
text files (whole or segmented) can be placed within that 
sub-directory. An error is flagged if a subdirectory of the 
given name already exists. 
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11.9.4 List Directory 

Selection of the list directory option displays the 
further command lines 

List [All ] Piles [without] Capture to Doc. [8] 

[Text] [with ] [1] 

[ 2 ] 

[3] 

[4] 

[5] 

[ 6 ] 

[7] 

Next, the pathname to the appropriate directory or sub¬ 
directory is entered via; 

Path! ] 

When capture of the listing is specified, the target 
document is opened if it is not already opened, and the 
directory listing is inserted at the current cursor location 
for that document. Whether or not capture is specified, the 
listing is also displayed on the currently selected screen 
window in the format: 


List of Text Files in 

Directory /MYTEXT 


Name 

Type 

Created 

Modified 

Blocks 

EX.DOC.1.LIB 

Text 

10-Feb-84 

13-Sep-84 

7 

EX.DOC.2 

Text 

10-Feb-84 

2-Jun-84 

6 

TABLE 

Text 

10-Feb-84 

3-Sep-84 

5 

WIDEDOC 

Text 

10-Feb-84 

2-Jun-84 

5 

WIDETABLE 

Text 

10-Feb-84 

2-Jun-84 

5 

SUPERWIDE 

Text 

10-Feb-84 

2-Jun-84 

6 

SCRAMBLE 

Text 

10-Feb-84 

2-Jun-84 

6 

FORMTEXT 

Text 

10-Feb-84 

2-Jun-84 

14 

LETTER 

Text 

10-Feb-84 

2-Jun-84 

8 

FORMFILL 

Text 

10-Feb-84 

2-Jun-84 

5 

FORMLETTER 

Text 

10-Feb-84 

2-J un-84 

4 

BUSY.BEE 

Text 

10-Feb-84 

10-Feb-84 

7 

EQUATIONS 

Text 

10-Feb-84 

10-Feb-84 

7 

On completion of 

the i 

display, the 

message: 


<Cont. on SPACE 

bar> 





is displayed. Pressing the SPACE BAR results in the 
currently selected document being re-displayed. 
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11.9.5 Volume Map 


The Volume Map displays the volumes currently on line, 
their capacity, and the number of free blocks, as follows: 



Volumes on Line 


Vol. Name 

Free Blocks 

Tot. Blocks 

MYTEXT 

41 

280 

PROFILE 

1860 

9728 
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12.0 FILE ORGANIZATION 

ProDOS files are physically stored on the disk in 
blocks, with each block holding 512 bytes. ProDOS itself 
views a file as a large linear address space of up to 16 
mega-bytes, with each byte individually addressable. The 
Apple // ProDOS format is fully compatible with the Apple 
/// SOS file format, and the SOS and ProDOS formatted 
diskettes differ only in the boot information stored in 
blocks 0 and 1 of track 0. 

Stemwriter creates and maintains two types of files, 
namely whole and segmented text files. It is also able to 
read ProDOS text (ASCII) files. The characteristics of 
these file types are: 

12.1 ASCII Files 


These files result when printer output is re-directed 
to a disk file. An example would be "printing" a Visicalc 
table to a disk file, using the Print Command. Such files 
consist of the straight text which would have been sent to 
the printer. The file has no reserved blocks for header 
information, and the text starts at block 0, position 0. 
The technique of "printing" a Visicalc table to a file, and 
then reading the file with Stemwriter, is a way to include 
calculated tables within a document. ProDOS text files are 
also ASCII files, in this context. 

12.2 Whole Text Files 


The organization of whole text files is shown in Fig 
12.1. Essentially, they are SOS Pascal Text files, with 
additional information stored in block 1. 

12.3 Segmented Files 

Segmented Files are whole text files, which have a 
Segment Access Table associated with them. The Segment 
Table holds pointers, which define the commencement and end 
of the required section of text from the text file. Each 
pointer pair occupies six bytes, and marks the absolute 
character positions of the first and last character in the 
referenced segment of the associated text file. This 
arrangement is shown in Fig 12.2. 

The Segment Access Table is named by Stemwriter, with 
the name SEGTBLnnnn, where nnnn is an identifier number. 
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Block 0 

Used by Pascal Editor 


Block 1 

Used by Stemwriter 


Block 2 

Commencement of Text 


Block nn 


Fig 12.1 Whole File Organization 

The name of an associated Segment Table is stored in block 1 
of the text file. Accessing a segment (say Segment 4) 
involves fetching entry #4 from the Segment Access Table 
file, and using the resulting start and end pointers to 
define the text to be fetched from the text file. Because 
text segments may be variable length, and are densely 
packed, Stemwriter permits the addition of new segments, but 
does not permit the alteration or deletion of a single file 
segment. This can, however, be done by loading the entire 
segment file to memory, making the necessary adjustments, 
and then re-writing to disk as a segmented file. 

Care must be exercised when copying or moving 
individual Segmented files. It is not advisable to use the 
standard ProDOS Filer Utilities for this purpose, as the 
Segment Table pathname stored in Block 1 of the parent file 
may have already been allocated to another Segment Table at 
the destination. The Stemwriter Utilities Program contains 
a utility which will correctly transfer a Segmented File, 
and its associated Segment Table, and rename the Table if 
necessary. As the Segmented File and its associated Segment 
Table are expected to always co-exist in the same directory 
or sub-directory, re-naming of the Volume causes no 
problems. Similarly, the Volume Copy option of the ProDOS 
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Segment Table File 




Fig. 12.2 Segmented File Organization 

Filer Utilities program can be used safely. 

File Segmentation provides a generalised facility for 
document boilerplating, selective printing of pages from 
formatted files, form letter creation, and list management 
(e.g. lists of addresses or references). 

12.4 Embedded Character Codes 


Stemwriter documents and files contain embedded codes 
with specific functions. These are common to all Stemwriter 
documents and files, and are not printer- specific. 
Stemwriter prohibits the inclusion of arbitrary control code 
sequences in text. This facility is unnecessary, as the 
task normally requiring such embedded strings is carried out 
by the correctly configured Abstract Printer. 
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Table 12.1 summarises all implemented codes. Table 
12.2 summarises the two-character sequences, used by the 
compression codes. The compression codes provide a compact 
way of representing multiple line feeds, strings of spaces, 
and micro-spacing. Formatting information for local and 
reserved fields is embedded in the text as shown in Table 
12.3. 


The three New Line characters deserve special mention. 
The hard new line (code 13) is an unambiguous call for a new 
line, and is obeyed by the Formatter, and the re- margining 
operations. The two conditional line breaks represent: 

(a) A line break at a <space> character, where the 
<space> character is replaced by the code (156) 

(b) A line break involving punctuation characters, where 
a line break is inserted by the code (28). 

During re-margining, and formatting, modified <spaces> are 
recovered, and inserted new line characters are discarded. 
Spaces following a conditional line break are adjusted to 
match the current Line Indent setting. This ensures that a 
gratitious increase in unwanted <space> characters will not 
occur as a result of formatting or re-margining. 
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Code 

3 

4 

5 

133 

6 

7 

8 

9 

10 

138 

139 
12 

13 

141 

14 

142 

15 

143 

16 

17 

145 

18 

146 

19 

147 

20 

148 
22 
150 
28 
156 


Table 12.1 

File and Document embedded codes 

Description 

Halt Printer 

Status String Terminator 

Set Alternate Margin 

Restore Normal Margin 

Line space compression code 

Bell 

Backtab for Overstrike 
Microspace Compression Code 
Line Feed 

Half Line Feed - Subscript 
Reverse Half Line Feed - Superscript 
New Page 

N« Line - Hard Line Break 

New Paragraph 

Bold on 

Bold off 

Underline on 

Underline off 

Space Compression 

Protect on 

Protect off 

Garment on 

Garment off 

Footnote on 

Footnote off 

Local Field car 

Local Field off 

Reserved Field on 

Reserved Field on 

Conditional New Line - Inserted character 
Conditional New Line - Substitute for <space> 


File Organization 



Part 3 - Reference 


291 


Table 12.2 
Compression Codes 

Char 1 Char 2 Description 

6 32+nn Advance carriage nn Half- lines 

9 32+nn Micro-tab nn microspaces (fill) 

16 32+nn Space Caipression (rep. nn spaces) 

Table 12.3 
Embedded Field Data 

<Field on><8 Status Bytes><4><.Field Text.XField off> 
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13.0 PRINTING (Closed Apple 6, Open Apple 6, Open Apple 3) 

Many word processors provide the facility to embed 
printer dependent control sequences in the text to control 
the printer attributes. The consequence of this approach is 
that filed documents can only be correctly printed by the 
one printer. Since not all printers have the same built-in 
capabilities, it also means that the power of a program of 
this kind to create suitably arranged printed copy is quite 
variable. Further, to print the document on another printer 
requires stripping out one set of printer directives, and 
replacing them by another set. This is a tedious process 
which is quite prone to error. 

Some word processors attack this problem by providing 
drivers for popular printers, which must be bound into the 
program before the printer can be used. 

Stemwriter takes an alternative approach to this 
problem. The Printing process is viewed as having three 
tiers. At the topmost level, Stemwriter generates 
generalised and standardised printer directives, either 
embedded in the text, or contained as part of the global 
environment information for that document or file. These 
Directives are, along with the text, transmitted to the 
Abstract Printer, which then refers to internal tables 
defining the attributes of the printer being used, and 
produces the actual command and character sequences needed 
for the requested response from that printer. Finally, the 
character and command sequences produced by the Abstract 
Printer are submitted to the Printer Driver for unmodified 
transmission to the printer. The Stemwriter program knows 
'what it wants done', but does not know 'how it will be 
done'. It leaves this task to the Abstract Printer, and the 
Printer Driver. 

The Abstract Printer assumes that the physical printer 
has certain basic capabilities, and is informed of relevant 
extended capabilities at configuration time. If the printer 
has built-in capability to produce some functions, then the 
Abstract Printer will exploit them. Otherwise it will, if 
at all possible, emulate those features, and send the 
required primitive commands to the physical printer. 
Examples are keeping track of page breaks ( the Abstract 
Printer has its own Vertical Formatting Unit), text 
underlining, and bold printing. The Abstract Printer knows 
what commands to give to the printer, but leaves the 
transmission of the commands to the Printer Driver. 
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The Printer Driver has a standardised interface to 
Stemwriter's Abstract Printer and is used to communicate 
with the printer card hardware, or firmware. This Driver 
knows how to 'talk' to the printer, but has no control over 
what is 'said'. Currently, three printer drivers are 
provided, viz: 


: Apple Parallel Interface Card 
: Apple Super Serial Card 
: Apple Pascal 1.1 Protocol 

The printer driver is contained as a separate module in the 
file STEM.DRIVER, and is loaded into memory at boot-up. The 
driver may, depending on its design, be initialized by the 
Device Configuration Block of the Abstract Printer. For 
details on creating your own drivers, and the listings of 
the provided drivers, refer to Chapter 17 of the Reference 
Section. 

There are thus two stages in configuring Stemwriter to 
suit a particular printer. Firstly, the communications 
interface used by the printer must be determined, the 
appropriate driver selected, renamed to the file 'STEM. 
DRIVER' on the Stemwriter boot diskette, and configured for 
the printer's communications protocol. Secondly, 

Stemwriter's Abstract Printer must have its Code Conversion 
and Printer Attributes tables correctly set for the printer 
in question. 

Printers normally have either a serial RS232-C, which 
uses the Apple Super Serial Card, (or similar), or a 
parallel (such as Centronics Parallel) communications 
interface which would require installation of the Apple 
Parallel Interface Card. 

To prepare for using an alternative printer, it is 
necessary to change the name of the selected printer driver 
file to 'STEM.DRIVER' using the Stemwriter Utilities 
program. Printer drivers have an associated configuration 
table, which tells the Driver the.conventions to be used for 
communication. This Table forms part of the Abstract 
Printer Configuration Data stored in the file 'STEM.CONFIG', 
and can be edited using the Stemwriter Utilities Program. 

Configuration of the Abstract Printer is effected with 
the Stemwriter Utilities program, and is fully described in 
Part 3 of this manual. Essentially, configuration involves 
setting table entries, which inform the Abstract Printer of 
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the type and capabilities of the physical printer, and the 
command sequences which correspond with Stemwriter printer 
directives. 

In some quarters, there is a tendency to use the term 
'serial' to describe those printers which accept and print 
characters one at a time, and 'parallel' for those printers 
which accept an entire line before printing. This is NOT 
the meaning intended here. 

Stemwriter executes the printing of a document or a 
file as a background task. Consequently, it is possible to 
use the full capability of Stemwriter whilst printing is in 
progress, with the following exceptions: 

(1) No File Operations are permitted until printing 
ceases 

(2) If printing a document from memory, then access 
to that document for any purpose is denied until 
printing ceases. 

(3) Formatting a Document cannot be initiated while 
printing is in progress. 

All other operations are legal and possible. Stemwriter 
polls the Printer Driver whilst waiting for keyboard entry, 
and sends a character to the printer if the printer is 
waiting. When printing a file, it is possible for keyboard 
entry to be lost whilst each block of the file is being 
read. Whilst this operation is in progress, the message: 

Please Wait... 

is displayed, to be replaced by: 

Thank You.... 

when Stemwriter is again ready to accept keyboard entry. By 
and large. Document and File printing uses 'slack' time, and 
does not interfere unduly with text entry, and editing. 

13.1 Initiating Printing 

Printing is initiated by pressing Closed Apple 6, to 
display the command line: 


Print [whole][File] with [saved] print data at [letter] Speed 
[segt.][Doc.] [new ] [draft ] 
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Selecting the [saved] option means that the global 
environment associated with the document or file is used for 
printing. The [new ] option is equivalent to pressing Open 
Apple 9, selecting the page break option, and using these 
new values for the duration of the printing task. The 
[new ] option is intended solely for the printing of 
unformatted documents or files, where page breaks have not 
been pre-calculated, and embedded in the text. It is thus a 
•quick and dirty' printing option. The [letter] and [draft] 
option applies for those printers, such as dot matrix 
printers, which have two printing speeds: high speed draft 
quality, and lower speed letter quality. 

Printing may proceed either from a file, whose pathname 
is requested from a subsequent command line: 

Path! ] 

or from a document, selected by the further command line: 

Print whole Document [1] 

[ 2 ] 

[3] 

[4] 

[5] 

[6] 

[7] 

[ 8 ] 

If the document selected for printing is the currently 
active one, the system acts as though key Closed Apple 9 had 
been pressed, and requests a new document. Access to the 
document being printed is denied until printing is complete. 
Otherwise, the cursor is returned to the currently active 
document. 

The whole/segt option applies only to the printing of 
files. On selection of the segt. option, one is presented 
with the command line requesting the segments to be printed. 
These must be provided as described in Section 11.4 on 
segment selection. 

The order of presentation of command lines is: 

Printer environment (if New selected) 

Document to be printed (if Doc. selected) 

Segments to be printed (if Segmented file) 

File Pathname (if File printed) 
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13.2 Printer Environment 

The Printer environment is set either by 

(1) Pressing key Open-Apple 9 and selecting the page 
break option 

(2) By selecting the new print data option at print 
time 

(3) During the initialization of document 
formatting. 

In each case, the identical command lines are 
presented, with identical meaning for the options. They 
will be discussed in detail here, and only mentioned briefly 

in the other places. Two command lines are presented in 
sequence, like so 

Page: Left!10] Head[30] Foot]3] Margins on Sheet[A][Norm] Font!12] StyletA] 


[B][Rot.] 

[10] 

[BJ 

[Cl 

[PS] 

[C] 

[D] 

[15] 

[D] 


Line Space [1 ] at [6] Line/Inch Paper Feed [Cant] Print Color [A] 

[1.5] [8] [Sing] [B] 

[2 ] [Cut ] [C] 

[3 ] ID] 

Reading from the left, one can set the first column to 
be printed (left margin in characters of selected font), and 
number of lines to be left free at the head and foot of the 
page, in single line spacing. The heading and footing space 
will be left clear when printing unformatted text, but may 
optionally contain text for formatted documents and files. 

The Stemwriter Utility initializes, Stemwriter with 4 
standard sheet sizes, coded as A to D.^ These sheet sizes 
are used in calculating page breaks, and in keeping track of 
the print head position relative to the page width. The 
Abstract Printer will not permit printing beyond the right 
hand page edge. So, provided that the page dimensions are 
correctly specified, and the paper is properly aligned, 
accidental printing directly on the printer platen cannot 
happen. The paper may be inserted normally ([norm]), or 
turned on its side ([Rot.]). By informing Stemwriter of the 
paper orientation, correct calculation of the page breaks, 
and the printing window still happens. It is frequently 
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necessary to turn a page on its side to accommodate a wide 
table. Also, it may be necessary to use non-standard sheet 
sizes, such as occurs when printing text for photo-reduction 
and subsequent offset printing. 

The Abstract Printer supports the selection of four 
print character sizes, ranging from 15 characters/inch to 10 
characters/inch, and including proportional spacing. A 
table of proportional character sizes forms part of the 
Abstract Printer. As some printers support several font 
styles, such as Courier, Prestige Elite, and Italic, the 
Abstract printer provides a facility for selecting one of 
four font styles. Where the physical printer will change 
font style on command, Stemwriter will automatically send 
the required font style selection sequence to the printer. 
It can also be instructed to pause for the change of print 
wheel, as required by daisy-wheel printers. These 
characteristics are configured with the Stemwriter Utilities 
program. 

Line spacing between successive printed lines may be 
specified in increments of 1, 1.5, 2 and 3 times the 
selected standard line spacing, which (if the printer 
supports both) may be either 6 or 8 lines per inch. On some 
printers which produce superscripting and subscripting with 
half-height characters, the option of 1.5 line spacing may 
not be possible. For this option to be available, the 
printer must be capable of both half-line feeds, and reverse 
half-line feeds. Most daisy wheel printers can do this, but 
not some dot matrix printers. However, 1.5 line spacing at 
6 lines/inch is equivalent to 2 line spacing at 8 line/inch. 

The continuous paper feed option is selected for 
tractor or pin feed paper. When the single sheet feed 
([sing]) option is selected, the printer starts in the 
halted state, with the message: 

Printer halted 

and remains in this state until the key Closed Apple 6 is 
pressed. Thereafter, the printer will halt at the 
completion of each page, to allow removal and insertion of 
the next page. 

The cut sheet option ([cut]) is for printers which have 
cut sheet feeders, and tells Stemwriter to send two pre¬ 
determined command sequences to the printer whenever a new 
sheet is to be inserted. The first command sequence selects 
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the bin, and the second loads the next sheet of paper. When 
a Dual bin sheet feeder is in use, the first sheet of a 
document is drawn from bin 1, and the subsequent sheets are 
drawn from bin 2. This allows one to use letter head paper 
for the first sheet, and plain paper for the remaining 
sheets of a document. 

The key Closed Apple 6 acts as an on/off toggle whilst 
a printer is active. Pressing it will re-start the printer 
if halted, or halt a running printer. The halting will be 
immediate if the printer itself is not buffered. This 
toggle can be executed from within any command line, without 
affecting the command option selection process in any way. 

When printing the currently selected document, the user 
is locked out of the document, and initially placed in the 
Command line: 


Display :: Window tA1 : Documentfl] 

and stays in this Command line until an alternative document 
is selected. If the single sheet mode of printing had been 
selected, the "Printer Halted" message would not be 
displayed, and the Bell would be sounded instead. Pressing 
Closed Apple 6 whilst within any Command Line will start or 
halt the Printer. 

Some printers support multi-color printing. For these 
printers, the Abstract Printer supports the selection of up 
to four print colors. 

13.3 Initializing The Printer (Open-Apple 6) 

The key Open-Apple 6 shows the following command line 

[Reset ] Printer to Page Head 
[Advance] 

When Stemwriter is initially booted, the Abstract Printer is 
initialized to assume the printer carriage is set to the 
page head. The options provide the capability to re¬ 
initialize the printer page registration ([Reset]), or to 
[Advance) the printer carriage to the head of the next page. 

This command will only operate if the printer is not 
already active. An attempt to use it when the printer is 
active produces the message: 
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Resources Unavailable CCont. on SPACE bar> 


13.4 Purging The Printer (Open-Apple 3) 

This command will halt the printing process, and will 
work from within a command line. The printer will stop 
immediately, unless the printer, or the printer control 
card, is buffered. Registration of the vertical position on 
the page is not affected by this command. 
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14.0 TEXT FIELDS (Closed and Open Apple 4, Closed Apple -) 


Stemwriter maintains special text fields for various 
purposes, and these are manipulated by pressing Closed Apple 
4, to show the command line 


[Begin] 

[Underline 

] Field 

[End ] 

[Bold 

] 

[Clear] 

[Footnote 

] 


[Protect 

] 


[Comment 

] 


[Local 

] 


[Reserved 

] 


The general procedure for creating a special field is 
to begin the field, type in the text comprising the field, 
and then close the field. This is most easily accomplished 
by appending to the tail of a document. It can also be 
accomplished by cutting the document, opening the field, 
inserting the field text, closing the field, and then 
repasting. A field cannot be initiated within the body of a 
document, but a technique to be described permits the 
placement of existing text within a field. To provide a 
level of protection against the creation of anomalies, the 
following activities are normally prohibited: 

(1) Cutting text within a field 

(2) Placing block or column markers within a field 

(3) Loading all or part of a file into a field 

(4) Attempting to delete a field marker by character 
deletion. 

Rejoining a cut document will normally cause the opened 
fields to be closed, and saving a document to a file will 
close off any open fields at the document end. 

Clearing a field simply removes the field markers, and 
leaves the text of the erstwhile special field intact. 
Therefore, if the entire field was to be removed, rather 
than changing the status of the field text, it would be 
necessary to use the block wipe command with the markers 
placed to bracket the field. 

14.1 Underline 


Underlining causes the text to be displayed, and 
printed as underlined. For compatibility with some 
printers, the <space> character is not shown underlined. To 
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underline a <space> use the underline character instead 
(shift-minus). 

14.1.1 Fast Underlining 

Underlining may be more efficiently controlled with 
Closed Apple which toggles the underline status. That 
is, if the underlining were off, it would be turned on, and 
vice-versa. 

14.2 Bold Characters 


Bold characters are displayed on the screen in inverse 
video, and printed in bold. 

14.3 Footnotes 

A footnote field is shown by the special characters i 
and If which bracket the footnote. These are directives to 
the formatter to place the footnote at the bottom of the 
formatted page on which the Begin Footnote marker was 
encountered. There may be more than one footnote on a page. 
Where there is insufficient room for the entire footnote, 
and the line containing the marker to appear on the same 
page, the page is foreshortened, and the marked line and the 
footnote will be carried over to the next page. The markers 
which define the bounds of the footnote are reminders only 
and are not printed. The footnote field may contain 
underline, bold, protected, comment, and local fields. It 
may not, however, contain a reserved field. 

14.4 Protected Field 

A protected field, bounded by the characters 1 and h , 
cannot be modified or edited by normal means. Its 
organization is unmodified by passage through the Formatter. 
A typical usage for a protected field would be a fill-in 
form, with only those areas where text entry is permitted 
being unprotected. 

14.5 Comment Field 


The comment field, bounded by characters—> and <—allows 
for the placement of reminder notes, fill-in instructions, 
etc which will not appear in the formatted or printed 
document. Both the formatter and the Abstract Printer 
discard comment fields. 
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Comment Fields come in two flavours, namely Classified, 
and Unclassified. An Unclassified Comment is simply a 
comment, and nothing more. A Classified Comment, on the 
other hand, permits the classification of segmented records 
for Sorting, Selection, and Form Letter creation. The 
format of a Classified Comment Field is as follows: 

—»<CLASS>Keyword<— 

The Classification Word (or Class Key) must occur 
immediately following the Comment Field On Symbol, and must 
be enclosed by angle brackets. The remainder of the comment 
is then the associated keyword. An example of Classified 
Comments from a segmented file of addresses would be: 

—»<FIRSTNAME>John<- -»<TITLE>Dr. <r- 

The detailed usage of Classified Comments is discussed in 
the appropriate sections, viz; Part 4 (The Utilities) for 
Sorting and Selection, and Chapter 16 for Form Letter 
Creation. 

14.6 Local Field 


The local field, delimited by the displayed characters 
^land tbi. has local formatting information for the Formatter, 
and the Abstract printer. In essence, the line break, and 
page break data obtained by selecting both options of key 
Open Apple 9 are embedded in code form in the body of the 
document, as follows 

<field on chr>< 8 status charsXchr 4X....Text.X field off char> 

Only the field-on and field-off characters will be 
visibly displayed on the screen. It is possible to change 
locally line width, line spacing, font and font style, left 
margin, print color, and so on. Refer to the section on key 
Open Apple 9, and the discussion of the Abstract Printer for 
full details. There are some restrictions when the 
formatter is creating multi-column documents. For example, 
the global line spacing prevails, and the local line width 
cannot exceed the global line width. 

Nesting of local fields is not possible. That is, a 
local field may not contain a reserved field, or another 
local field. The same effect, however, may be obtained by 
breaking the text into a string of local field sections. A 
local field may, however, contain underlined, bold, comment. 


Text Fields 





Part 3 - Reference 


303 


and protected fields. It may not contain a footnote field. 

14.7 Reserved Fields 

A reserved field, designated by the markers ^ and P, is 
essentially a local field with some additional properties. 
That is, a reserved field must fit entirely on the one page, 
or in the one column in the case of a multi column page. On 
passage through the formatter, the entire reserved field is 
moved relative to the document text to achieve this aim. A 
reserved field occurs no earlier in the formatted document 
than its placement in the unformatted document. There is no 
restriction on line width for reserved fields in multi- 
column pages. A wide field, if not already there, is simply 
moved to the top of the next page, and then any carry-over 
standard reserved fields are added. For single column 
pages, a reserved field occupies the depth specified by the 
number of lines, and local line spacing. This is also true 
for wide reserved fields on multi-column pages. Standard 
reserved fields in multi column mode use the global line 
spacing. 

Standard reserved fields which cross column or page 
boundaries are moved to the top of the next column or page. 
Where reserved fields queue up, their order of occurrence is 
not altered, save for wide reserved fields on a multi-column 
page, which take precedence over standard reserved fields. 

The same restrictions on field nesting as for local 
fields apply. 

Examples of reserved fields may be space left for 
graphs or photographs, tables of figures, mathematical 
equations, and so on. 

14.8 Defeating Field Interlocks 

The normal field protections may be controlled by 
pressing Open Apple 4, to obtain the command line: 

Turn Special Field Markers Con ] 

[off] 

When the markers are turned off, the following applies: 
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(1) Editing of protected fields is possible 

(2) Placement of block operation markers in special 
fields is permitted 

(3) Fields are not closed off on repasting 

(4) Text from a file may be loaded into a field 

Thus, all protection has been removed and extreme care must 
be exercised to ensure that no anomalous situation arises. 

To place existing text within a special field, execute 
the following steps: 

(a) Turn off the special field markers 

(b) Cut the text at the start of the field 

(c) Begin the field 

(d) Re-paste the text 

(e) Move to the end of the text to be placed in the 
field 

(f) Cut the text 

(g) End the field 

(h) Re-paste the text 

(i) Turn on the special field markers 

It is essential that the Begin Field Marker precede the 
End Field Marker in the text. 

14.9 Problems when Interlocks are Inactive 


The Field Interlocks are there to protect the user from 
ill-considered, or careless actions. Such actions may be 
loading a file into a field, or a block or column operation 
with carelessly placed markers. Therefore, the field 
interlocks should usually be active. However, given that 
the field interlocks are inactive, and an ill-considered 
operation has created unmatched markers, how does one 
recover? 

For the visible field markers, viz Comment, Footnote, 
Local, Protected, and Reserved Fields, it is easy to see 
which marker pair has been affected, and then recover as in 
Section 14.8. One should always move the cursor forwards 
through the text from a point preceding the field in 
question, to the position where the marker will be restored, 
so that the correct Field Status is registered by 
Stemwriter. Otherwise, for example, Stemwriter may insist 
that a Field is already off, when one tries to replace a 
missing Field Off Marker. 
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For the invisible markers. Underline and Bold, it is 
not quite so obvious. The first thing is to detect that a 
marker is absent. If the operation causing the problem was 
a Block Wipe or Copy, then it is possible for there to be 
one unmatched marker, at the origin, or destination position 
in the text, respectively. If the operation was a Move, 
then there could be a marker mis-match at both the origin 
and destination locations for the moved text. 

The unmatched marker makes its presence known after a 
scrolling or repaint operation when a passage of text seems 
to be in a field, when it should not be. To rectify the 
situation, place the cursor on the text showing the spurious 
attribute, and select the Clear Underline or Bold (as the 
case may be) operation. The Clear Field operation removes 
either a pair of matched Field On, Field Off markers, or any 
unmatched marker of the specified field type in the region 
adjacent to the Cursor. Thus the marker anomaly will be 
removed, and valid markers will remain untouched. Then, if 
a passage of text needs to be re-placed in the field, 
proceed as in Section 14.8. 

An unmatched marker created by a careless operation 
when the field interlocks are off, may cause serious 
problems when the text is formatted. 
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15.0 FORMATTING ( Open Apple 0) 
15.1 Overview 


The formatting strategy for Stemwriter is to draw a 
distinction between documents which have been saved with 
minimal but legible formatting information, and those 
documents which have been fully formatted to include page 
breaks, headers, footers, placement of footnotes, and so on. 
This ensures that the re-formatting of text for different 
purposes, can be done conveniently, without the need to 
'unformat'. Further, the transfer of text between 

documents, to build new documents which draw on earlier 
documents, is not impeded by the need to manually remove 
differing formatting directives. Consequently, fully 

formatted Stemwriter files are intended for printing only, 
and not for use in document-building exercises. 

The Stemwriter formatter accepts text from a document 
or file, and transfers the formatted text either to another 
document, or a file. In passage through the formatter, all 
conditional line breaks are removed, the original paragraph 
indents are removed, and the newly specified conditions are 
used to re-margin the text. Page breaks are calculated and 
page break information is inserted. Optional headers and 
footers, and page numbering are added. 

When specified. Headers and Footers are drawn from 
separate documents, and have their own local environment, 
independent of the environment of the body of the text. It 
is possible to have full-width Headers or Footers with 
multi-column printing with different line spacing, and font 
selection from that used in the body of the text. 

When accepting unformatted text from a file, or 
sending formatted text to a segmented file, the Formatter 
uses two of the eight documents as scratch pads. The 
scratchpad for file input always contains at least the 
entire text of the last formatted page. This is 

particularly useful for interactive formatting using the 
Formatting Preview option. 

Formatting may proceed in a 'batch' mode of operation, 
or in an interactive manner. The interactive manner is 
selected by specifying the Page Preview option. In this 
mode of operation, one is able to preview the formatted 
page, and carry out any adjustments on the unformatted text, 
so that, for example, page breaks fall in convenient places. 
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It is possible to re-format the most recently formatted page 
after editing the source text. The general arrangement for 
the flow of text during formatting is shown in Fig 15.1. 



Fig. 15.1 Text flow during formatting 


15.2 Alternating Margins 

A glance at a book with printing on both sides of the 
sheet will show that the left and right margins alternate 
depending on whether the pages are odd or even numbered. 
Similarly, page numbers are often placed away from the book 
spine, meaning that they have to alternate with odd and even 
pages. Stemwriter permits the independent specification of 
normal (fixed) or alternating left and right margins for 
page numbering, Headers, Footers, and the text body. 
Essentially, alternating the margins produces mirror-image 
margin and text placement. 

15.3 Hyphenation Control 

Stemwriter permits two levels of hyphenation control 
during formatting. Hyphenation of long words can aid an 
aesthetic appearance, particularly for fill-justified, 
multi-column printing. To be considered a candidate for 
hyphenation, a word must contain at least six characters. 

Automatic hyphenation requires that the hyphenation 
point be as close as possible to the specified line length, 
and no less than three characters from either end of the 
word. No phonetic checking is done. 

Manual hyphenation requires the operator to specify the 
hyphenation point. Candidates for hyphenation are 
displayed, with a vertical line indicating the position of 
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exact line length, like so: 

Move Cursor to break point. Accept with <ENTER> 

Hyphenate: superfl|ous 

The hyphenation position is set by doing as the command line 
indicates, moving the cursor to the chosen break point, and 
pressing ENTER. The hyphen is inserted immediately in front 
of the character under the cursor. 

15.4 Reserved Fields 


The creation of Reserved Fields has been described in 
Section 14.7, and their interaction with the Formatter was 
briefly alluded to. Essentially, a Reserved Field is a 
piece of text which must not be broken by a page boundary. 
When one considers that a draft of a document could well be 
printed single column, with double line spacing, to allow 
space for pencilled corrections, and the final document 
could be printed in two column 1-1/2 line spacing, it can be 
seen that the manual disposition of space reserved for 
diagrams, photographs, etc, or the relocation of tabular or 
complex mathematical equations in the text, becomes a 
difficult task. For these type of inserts, it is critical 
that they do not occur earlier than a certain point in the 
text, but they may conveniently be placed later than that 
point. The Reserved Field has been defined specifically to 
deal with this problem in a logical way. 

As described earlier, a Reserved Field has its own 
local environment. More to the point, it tells the 
Formatter that it may delay the text of the Field relative 
to the ordinary text to avoid page boundaries. When a large 
Reserved Field is followed by a smaller Reserved Field, it 
is possible for the order of the Fields to be reversed. 
Should this effect occur, and be unwanted, manual adjustment 
of the text, followed by re-formatting of the last page, is 
required. Under extreme conditions, the number of Reserved 
Fields may bank up, until more Reserved Fields have to.be 
placed on a new page than there is space to receive them. 
This results in the error message: 

Fields Overflow <Cont. on SPACE bar> 

and the termination of the formatting process. This 
problem, if it occurs, requires the revision of field 
placement in the unformatted text for a solution. 
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15.5 Footnotes 


A Footnote Field is a directive to the Formatter to 
place the Field text at the foot of the page in single 
column documents, or column for multi-column documents. As 
described for Reserved Fields, the formatting conditions for 
draft documents and the final document can differ markedly, 
causing difficulties for manual footnote placement. The 
Formatter will automatically ensure that a footnote is 
placed at the foot of the page on which the start of 
footnote marker occurs. If too many footnotes are to be 
placed at the foot of a page, or there is an unresolvable 
interaction with accumulated Reserved Fields, the message: 

Fields Overflow CCont on SPACE bar> 


is given. The formatting process is terminated, and the 
user must then re-consider the placement and size of the 
footnotes, and Reserved Fields. 

15.6 Preparation For Formatting 

Before formatting is commenced, the Header and Footer 
documents must be created, if required, and supplied with 
their own line break and printer environment by selecting 
both the [line] and [page] options on numeric key Open Apple 
9. These global statistics for the Header and Footer become 
the Local Field statistics for the copies of the Header and 
Footer documents added to each page of the formatted 
document. Failure to create the Header or Footer document 
will result in the error message: 

Doc. not opened <Cont. on SPACE bar> 


or, worse, will use the (unwanted) text of an existing 
document as a Header or Footer. Pressing the SPACE bar will 
restore the offending command line, whence an error in 
specifying Header or Footer document may be rectified, or, 
alternatively, the formatting process discontinued by 
pressing ESCAPE. For file input, the selected input scratch 
document must be unused. The destination or scratch 
document for receiving the formatted text must also be 
clear. If these pre-conditions are not met, the error 
message: 

Duplicate Document Usage <Cont. on SPACE bar> 
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is given. Pressing SPACE restores the offending command 
line. One can then optionally alter the document selection, 
or ESCAPE to repeat the pre-formatting initialization. 

15.7 The Formatting Command Lines 


When the pre-conditions are satisfied, formatting is 

commenced by pressing Open Apple'0 to display in order the 
command lines: 


Print Format [Doc. HI] to 

[Doc.][2] 

[with ] Page Preview 

[No ] Hyphenation 

[File] [2] 

[File] [3] 

[without] 

[Auto] 

[3] 

[4] 


[Man. ] 

[4] 

[5] 



[5] 

[6] 



[6] 

[7] 



[7] 

[8] 



[8] 

[1] 




As an aid to proof reading a document, it is possible 

to specify that the Formatter number the lines or paragraphs 
on a page. The line or paragraph numbering is re¬ 
initialized at the start of each page. These numbers appear 
in the right margin. 

Headingtoff] Footing [off] Page Numbering [off] [Line] Numbering [off] 
[on ] [on ] [on ] [Para] [on ] 

The next three command lines have been described fully under 
Section 13, PRINTING, and Section 7.3, Setting Line/Page 
Breaks. 


Line: Para Indent 15 ] Line Indent [£ ] Line Width [60 ] 


Page: 

LeftflO ] Head[3 ] Foot[3 ] Margins on 

Sheet [A][Norm] 

Font!12] Style[A] 




[B][Rot.] 

[10] 

[B] 




[C] 

[PS] 

[C] 




[D] 

[15] 

[D] 

Line Space [1 ] at 

[6] Line/Inch Paper FeedtCont] Print Color [A] 



[1.5] 

[8] 

[Sing] 

[B] 



[2 ] 


[Cut ] 

[C] 



[3 ] 



[D] 


If 

the Heading 

switch is on, the 

source of the 

Heading 

is 


requested: 
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Heading from Doc.[3] with 

[Norm] Margins 

[4] 

[Alt.] 

[5] 


[6] 


[7] 


[8] 


[1] 


[21 



The Footing switch optionally requests the source of the 
Footing text: 


Footing from Doc.[4] with 

[Norm] Margins 

[5] 

[Alt.] 

[6] 


[7] 


[8] 


[1] 


[2] 


[3] 



Optional selection of page numbering permits the entry of 
the first page number to be used, the line of the Header or 
Footer to receive the page number, the column position 
(actual number of character spaces, at left margin, or at 
right margin), and whether the positioning is to alternate 
with successive pages. If the specified line number places 
the page numbering position outside the selected Header or 
Footer, the error message: 

Page No. not in Head/Foot CCont. on SPACE bar> 


is displayed, and on pressing the SPACE bar the command line 
is repeated. 

First Page# [^1 ] at Line Cl ] of [Heading] and Col.[1 ] [Norm] Margins 

[Footing] [Lft] [Alt.] 

[Rgt] 

The conditions for the body of the document specify 
whether the text is to be formatted with smooth left, ragged 
right margins, ([left]), or whether the spaces are to be 
filled to give smooth left and right margins ([fill]). 
Filling, if selected, is done by microspaces, with the 
required fill distributed evenly over the available fill 
sites (inter-word spaces). This option is selectable 
independently of the font chosen. One does not need to have 
chosen proportional spacing. For those printers which do 


Formatting 






312 


Part 3 - Reference 


not support microspacing, the Abstract Printer accumulates 
space fractions till an additional whole space can be 
inserted at a fill site. This results in filling by whole 
space multiples, with the additional spaces evenly 
distributed across each line. Thus, the identically 
formatted document will be printed in the way most suitable 
to the printer chosen, without needing to be re-formatted. 

Multi-column printing of up to four text columns can be 
selected. The Formatter arranges the corresponding lines 
from the different text columns into wide lines, so that 
multi-column printing can occur for all printers. Again, 
normal or alternating margins may be selected, to give 
'mirror-image' printing. If the column width specified is 
narrower than a given word, the offending word is wrapped to 
the next line without hyphenation, unless one of the 
hyphenation options has been specified. 


Text Justification [Left] 

with [1] Text Coluims 

[Norm] Margins 

[Fill] 

[23 

[Alt.] 


[3] 



[4] 



When multi-column formatting is selected, the inter-column 
margins are individually selectable. 

Inter-Column Margins: l-2[ji ] 2—3[3^ ] 3—3[3^ ] 

When the text is coming from a file, the pathname must be 
supplied. The file must exist, and may be either a whole 
file, or a segmented file. The formatter treats segmented 
files as though they were whole files. 


From[ ] 

The password must be given if the source file was encrypted. 

Password! ] 


When the destination of the formatted text is a file, its 
pathname must be supplied. This file will be a segmented 
file, with each formatted page occupying a segment. 
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When all the above data has been entered, Stemwriter 
checks that the total line width does not exceed the width 
of the selected sheet. This is relatively easy to overlook 
when multi-column printing, where one must multiply the 
column width by number of columns, then add on the left 
margin and the inter-column margins, to obtain the total 
line width. If all is OK the screen window clears, and the 
message : 

Formatting Page 1 

is displayed. If a mistake has been made in calculating 
total line width, the task is terminated with the message: 

Line too wide <Cont. on SPACE bar> 

If the [without] preview option had been selected, the 
command line message will always show the number of the page 
currently being formatted. When the task is done, the 
message : 

Formatting Complete 

is displayed, and the display returns to the document from 
which the formatting operation was initiated. 

15.8 Formatting With Page Preview 

When the Page Preview option is selected, the formatter 
halts when the end of the page is reached, and displays the 
most recently formatted page, with the message: 

Previewing Page 1 

One is then able to check if the formatting were 
satisfactory, that the Reserved Fields have been correctly 
placed, and that the page breaking calculation has created 
no widow or orphan paragraphs. If anything unsatisfactory 
is noted, the source document can be entered, and edited 
(note the proviso in 15.8.1). As a convenience, the cursor 
position in the source document 'tracks' the Formatter, and 
will be positioned at the head of the last line sent to the 
formatter. When one is satisfied, the formatting process is 
re-started by pressing Open Apple 0. A new command line 
appears, viz: 

[Continue] formatting at [this] page 
[Cease ] [prev] 
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One can optionally abandon the formatting process if 
the modifications needed were too drastic, or formatting of 
the entire document was not needed. Alternatively, one can 
continue, but re-format the last page by specifying the 
option [prev], or continue as normal by specifying [this]. 
Ceasing at the [prev] page destroys the last page formatted, 
but leaves the preceding formatted pages intact. 

Editing of the formatted text is generally prohibited, 
as even the most apparently innocuous changes may have 
unforseen effects. For example, altering a single character 
in proportional, filled text may produce a line shorter, or 
longer than its neighbours, thus destroying the appearance 
of the document. An attempt to edit the formatted text 
results in the message: 

Forbidden-Formatted Doc. 

As an aid to rapidly moving over the text, and performing 
desperation modifications, the Find/Replace/Verify command 
works on the formatted text. The Replace/Verify command 
must, however be used with extreme care, as its usage could 
utterly destroy the appearance of the formatted text. In 
short, one is permitted only to view the formatted text, or 
to make limited changes at one's own peril. 

15.8.1 A Warning 

To make the Preview operation as flexible and powerful 
as possible, the Block Operation commands, and the Delete 
Character command will work on the Source Document during 
formatting. Although one is prohibited from clearing the 
source document, or source scratch document by means of the 
Clear Document Command, the same result may be achieved by 
using the Block Wipe command to encompass the entire 
document. DON'T DO IT1! 

The Block Operations or Delete Character commands may 
be used in perfect safety, except for the following 
combination of circumstances: 

(1) The Source Document is modified by an extensive 
operation which affects the first character on 
the Preview Page, and 

(2) Formatting re-commences at the head of the 
current page ([prev] option). 
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In these circumstances, it is possible for the formatter to 
lose track of the position of the page head, and 
unpredictable results may occur. However, this situation 
will never arise if modifications to the source document are 
limited to minor corrections in the body of the page being 
previewed. 

Therefore, if one observes that major changes to a 
document are required during the formatting process, cease 
formatting, make the changes, and then re-start formatting. 
Not only is this safer and cleaner, but it is then possible 
to save a copy of the corrected source document to disk for 
future reference. 
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16.0 FORM LETTER CREATION (Open Apple 5) 

Stemwriter creates Form Letters by drawing text from a 
segmented file and then merging it with a template document. 
The body of the segment forms the postal address, and the 
Classified Comments provide the text to be inserted at the 
appropriate place in individualised letters. A sample 
Segment from a segmented Address File might be: 

Dr James Brown 
221 Faculty Drive 
University of Wherever 

Research City-XRESEARCH>Medieval Literature^- 4<SALUT>Jim<- 
-><FACULTY>Arts<--><SORTKEY>BROWNJ<- 

Here, the Classified Comment Fields contain information on 
Research Interest, Faculty, and salutation to be used. The 
<SORTKEY> allows the records to be sorted in alphabetical 
order on Name. Preparation for creating a series of Form 
Letters starts with the creation of a suitable Template 
Document, such as the following: 


April 26, 1985 


4<ADDRESS><- 
Dear -XSALUT>4-> 

I am writing to congratulate you on the sterling work 
you have done in the past year. Due in no small part to the 
way in which you have pursued your interest in <RESEARCH>$-, 
the Faculty of —XFACULTY><- at this University has been able 
to enhance its already high reputation. Well Done, and keep 
up the good work! 


John A Goodfellow 


Chancellor 


Personalization of such a template is achieved by replacing 
the Class Keys in the Template by the keyword associated 
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with that Class Key from each Segment Record. The Class Key 
<ADDRESS> is a special reserved word, which is replaced by 
all text in a segment not within comment fields; in th^s 
example, the postal address. The combination of the example 
template and example segment would produce the personalised 
letter : 

April 26, 1985. 


Dr James Brown 
221 Faculty Drive 
University of Wherever 
Research City 

Dear Jim, 

I am writing to congratulate you on the sterling work 
you have done in the past year. Due in no small part to the 
way in which you have pursued your interest in Medieval 
Literature, the Faculty of Arts at this University has been 
able to enhance its already high reputation. Well Done, and 
keep up the good work! 

John A Goodfellow 


Chancellor 


Once the pre-requisite Template Document and file of 
Segmented Records have been created, the process of creating 
the personalised documents is commenced by pressing Open 
Apple 5, to display: 


mplate from Doc[l] using 
[ 2 ] 

[3] 

[4] 

[5] 

[ 6 ] 

[7] 
t83 


Address File[2] to File!3] 


[33 

[43 

[41 

[5] 

[5] 

[63 

[63 

[73 

[73 

[83 

[83 

[13 

[13 

[23 


The documents associated with the Address File, and the 
Destination File must be free, as they are used as scratch 
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documents. The Address File must be a Segmented File. 
After this Command Line is accepted, one is asked for the 
pathname of the segmented Address File: 


From[ 

1 

and then the pathname of 
personalised letters: 

the Whole File to receive the 

To[ 

] 


Each Segment from the Address File is fetched in turn, and 
its information is merged with the Template Document to 
create a new document in the scratch area associated with 
the Destination File. The margining of this new document is 
verified, and it is then written to the destination file. 
This process continues until all records have been 
processed. This file of personalised letters can then be 
printed as a background task while Stemwriter performs other 
duties. The Label Utility from the Utilities program can be 
used to process the segmented Address File to print the 
adhesive envelope labels (Refer tp Part 4 - The Utilities 
for details). 

When combined with the Sorting and Selection tasks of 
the Stemwriter Utilities Program, and the use of multiple 
Template Documents, this command provides a flexible and 
convenient way for creating individualized Form Letters. 

For example, the parent Address File may be first 
scanned to produce daughter Address Files of those persons 
satisfying certain criteria. Then, the appropriate Template 
Document is matched up with each Daughter Address File to 
create the required Form Letters Files. 
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17.0 PRINTER DRIVERS 

Stemwriter provides a three tier control of the 
Printing Process. At the top tier, Stemwriter itself 
produces generalised printer requests. These are then 
converted by the Abstract Printer into printer-specific 
characters, and command strings. Finally, the Abstract 
Printer hands on these character strings and command codes 
to the Printer Driver, for transmission to the printer 
itself. 

Stemwriter expects the Printer Driver to be able to 
provide the following services: 

Status Request : For proper operation of the Background 
Printing feature, Stemwriter must know if a printer is ready 
to accept input, before attempting to provide it. 

Initialization : It must be possible to set the initial 
state of the printer and/or the printer interface card. 

Write : Send a character to the printer. 

In carrying out these tasks, the Printer Driver must not 
attempt to display any information on the Text Pages. Doing 
this will destroy important tables of information used by 
Stemwriter. The 'holes' in the Text Page normally 
associated with the slot containing the driver card, may be 
used quite freely. The Driver must save and restore the 
contents of any Zero Page memory locations that it uses. 

Not all firmware on driver cards meet the above 
criteria, and it may be necessary to create a Driver which 
operates directly on the Controller Card's hardware, rather 
than simply interfacing to the Controller Card's firmware. 
Further, a properly designed Driver may make the Controller 
Card configuration settable by table entries, and 
independent of the settings of switches on the Card itself. 

17.1 Driver Protocol 


The Driver is a piece of absolutely located binary 
code, which executes from the memory address $1E00. It may 
occupy up to 512 bytes. The skeleton of a typical Driver 
might be: 
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.ABSOLUTE 

;(Declaration needed for Pascal Assembler) 


.ORG 

$1E»0 

;The Absolute Address of the Code 

SL0T16 

.EQU 

$4140 

;Card Slot Nurrber by 16 

DCB 

• EQU 

$4141 

;Ccnfiguration Data, etc (7 bytes) 


JMP 

SINIT 

;Link to Initialization Routine 


JMP 

SSTAT 

;Link to Status Routine 


JMP 

SVRIT 

;Link to Write Routine 


Shells of Routines follow 


SINIT 


RTS 

SSTAT ... 

RTS 

SWRIT ... 


RTS 

.END 

The first three instructions must be the jump links to the 
Driver Code, in the above order. Stemwriter executes these 
instructions via a JSR call to these links. The last 

instruction in each procedure must therefore be RTS, to 
return control back to Stemwriter. SLOT16 points to the 
Abstract Printer Configuration Table, and contains the Slot 
Number (multiplied by 16) where the Peripheral Card resides. 
DCB refers to 7 bytes of information in the Abstract Printer 
Configuration Table, whose usage is Driver-specific. 
Recommended usage is for providing setup data for 

initialization, error masks, and suchlike. 

Protocols 

Registers 
A X Y 

SINIT (entry) d.c. d.c. d.c. 

(exit) d.c. d.c. d.c. 


Carry 

d.c. 

d.c. 
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SSTAT (entry) d.c. d.c. d.c. d.c. 

(exit) Err Code d.c d.c Set(Free to send) 

Reset(Busy) 

Note: Err Code must be 0 for no error 

$30 for error detected 

SWRIT (Entry) Char. d.c. d.c. d.c. 

(exit) d.c. d.c. d.c. d.c. 

Note: d.c. means "don't care". 

As the Abstract Printer is configured to provide 

exactly the character strings required by the printer, the 
Driver must not modify the character stream in any way. 

17.2 Apple Parallel Interface Card 

The on-board firmware with this card does not provide a 
Status Check, and, after writing a character to the printer, 
waits for acknowledgement before returning control to the 
calling program. Therefore, it is unable to properly 

support Background Printing. The supplied Driver (Listing 
17.2.1) operates directly on the Hardware, and fully 

supports the required protocol. In addition, it is able to 

read the second 8 bit port on the Card, for the detection of 
printer errors. The printer interface cable would have to 
be correctly wired for this to work. The usage of the DCB 
entries supports this: 

DCB Set bit lo if error condition is bit Hi 

(& vice-versa) 

DCB+1 Set Bit Hi if used to detect error Condition 

The contents of the input port are EOR'd with DCB and then 
ANDed with DCB+1. A result of Zero means no error. To 
disable this test, simply set DCB+1 to zero. 

17.2.1 Listing of Parallel Driver 


****************************************** 


★* 

Parallel Interface Card 

** 

** 

Driver Software 

** 

** 

Copyright (C) 1984 

** 

** 

7M Systems Consultants Pty Ltd 

** 


****************************************** 
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This Listing is for assembly by the Apple /// Pascal 
Assenbler. After Assembly, the Code File has to be 
passed through the SOS Utility MAKEINTERP, supplied with 
the SOS Reference Manual, to produce a Binary File. This 
program simply removes the first and last blocks frcm the 
file. 

With very minor changes to seme imemonics, this 
source code can be assembled by the ProDOS Assanbler, to 
directly produce the required Binary File. 


Device Driver starts here 

.ABSOLUTE 

.NDLIST 

.PROC PARPRT 

•ORG 1E00 ;Absolute Starting Address 


Configuration Table Equates 


SL0T16 

.EQU 

4140 

;Slot # by 16. 

DCB 

.EQU 

4141 

;Device Configuration Block 


Peripheral Card Hardware Registers 


0C080 


Load Output Port to Write 


0C082 


Said Strobe 


0C083 


Read Input Port 


0C084 


Read ACK Status (Bit 6) and 

ACk flip-flop (bit 7) 


0C086 


Enable Interrupt capability 


0C087 


Disable Interrupt,reset ACK flip flop 
Disable autostrobe feature 

DOFS 

JMP 

SINIT 

;Initialization despatcher 


JMP 

SS73AT 

;Status Despatcher 


JMP 

SWRIT 

; Writer Despatcher 


Parallel printer Initialization 

SINIT 

IDX 

SIOT16 



STA 

0C087 ,X 

;Clear ack, etc. 


RTS 

Parallel printer Status 

On Exit Carry set if Acknowledge received 
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A has error Code 

NOTE: the value of Bit 0 is NOT ACKNOWLEDGE 
(error in the PIC Manual) 


SSTAT IDX SIOT16 

IDA 0C084,X 

CLC 


;Clear Carry, expecting BUSY 


We assume that the character has been accepted if: 

(1) Acknowledge flip-flop is set AND: 

(2) The Acknowledge signal has gone low 

This double-barrelled check gives some noise immunity 



AND 

*81 

;Mask ACK flip-flop and NOT ACK 


EOR 

#81 

;Test if both bits set 


BNE 

$05 

;No, so printer is busy 


SEC 


;Yes, so flag printer ready 

$05 

IDA 

0C083,X 

;Ioad Printer Status 


BOR 

DCB 

; Toggle the mask to set error bits 


AND 

DCB+1 

;and then mask the error bits 


BBQ 

$10 

;Branch if no errors detected 


IDA 

#30 

;Printer Error Message 

$10 

RTS 




; Write character to the printer 

; On entry Character to be written is in A 

SWRIT IDX SL0T16 

STA 0C080,X ;Place on output Latch 

STA 0C082,X ;and strobe it 

RTS 

.END 


17.3 Apple Super Serial Card 


The Apple Super Serial Card uses a SY6551 ACIA as the 
serial communications device. Although the firmware on this 
card supports the Pascal 1.1 protocols, there are problems 
with implementing serial communications in this way: 
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(1) The 16 initialization characters provided by the 
Stemwriter Abstract Printer are insufficient to 
fully initialize the ACIA via the firmware, and 
the Generic Pascal 1.1 Driver. 

(2) Problems occur with XON/XOFF protocol when 
printing a background file. Because interrupts 
are not used, the XON/XOFF control characters 
from the printer may become lost or garbled while 
the CPU is busy reading the next block from the 
disk, resulting in faulty communications. 

(3) The Escape Character required by the firmware 
means that the full ASCII character set cannot be 
transmitted without a 'kludge'. 

(4) The ETX/ENQ protocol is not set up to operate in 
the same way as the SOS Driver, .RS232. 

Listing 17.3.1 is the provided Serial Card Driver, 
which operates directly on the Registers of the ACIA, to 
solve the above problems. 

17.3.1 Serial Driver Listing 


****************************************** 


** 

Super Serial Card 

** 

** 

Driver Software 

** 

** 

Copyright (C) 1984 

** 

** 

TM Systems Consultants Ptv Ltd 

** 

**********4******************************* 


This Listing is for assembly by the Apple /// Pascal 
Assanbler. After Asssnbly, the Code File has to be 
passed through the SOS Utility MAKEINTERP supplied with 
the SOS Reference Manual, to produce a Binary File. This 
procedure discards the first and last blocks of the file. 

With very minor changes to sane mnemonics, this 
source code can be assembled by the ProDOS Assembler, to 
directly produce the required Binary File. 

Device Driver starts here 

.ABSOLUTE ;Code must be absolute 
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.NOLIST 

.PROC SERPRT ,-Required by Pascal Assanbler 

.ORG 1EOO ;Starting Address for all drivers 

This driver is designed to work with the Apple Super Serial Card 

vrtiich incorporates the SY6551 ACIA 

The following presumes this to be the case 

Card Hardware Registers for the SY6551 are: 


0C088 

Transmit 

(write) 


Receive 

(read) 

0CO89 

Reset 

(write) 


Status 

(read) 

0CO8A 

Camand 

(read/Vrite) 

0C08B 

Control 

(read Anri te) 


Abstract Printer Configuration Table Equates 

.EQU 4140 ;Slot # by 18. 

.EQU 4141 jDevice Configuration Block 

Serial Interface DCB usage is : 

DCB Baud Rates 

0 16*Extemal Clock 


1 

50 

Baud 

2 

75 

Baud 

3 

109. 

92 Baud 

4 

134. 

58 Baud 

5 

150 

Baud 

6 

300 

Baud 

7 

600 

Baud 

8 

1200 

Baud 

9 

1800 

Baud 

0A 

2400 

Baud 

OB 

3600 

Baud 

OC 

4800 

Baud 

0D 

7200 

Baud 

0E 

9600 

Baud 

OF 

19200 

Baud 
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DCB+1 

Character Bits 



0 

8 bits per char, 1 stop bit 



1 

7 bits per char, 1 stop bit 



2 

6 bits per char, 1 stop bit 



3 

5 bits per char, 1 stop bit 



4 

8 bits per char, 2 stop bits (1 with parity) 



5 

7 bits per char, 2 stop bits 



6 

6 bits per char, 2 step bits 



7 

5 bits per char, 1.5 stop bits 


DCB+2 

Parity 



0 

No Parity 



1 

Odd Parity 



3 

Even Parity 



5 

Mark Parity 



7 

Space Parity 


DCB+3 

Communications Mode 



00 

No handshake 



01 

ENQ/ACK 



40 

Hardware Handshake 



80 

JDN-XDFF Handshake 


DCB+4 

XDFF Char ($13) 



ENQ 

Char ($05) 



BEX 

Char ($03) 


DCB+5 

XDFF Char ($11) 



ACK 

Char ($06) 


DCB+6 

Block size for ENQ/EMX transmission 

DOFS 

JMP 

SINIT 

initialization despatcher 


JMP 

SSTAT 

;Status Despatcher 


JMP 

SWRIT 

;Writer Despatcher 


Serial 

Interface Card Initialization 

SINIT 

IDX 

SIDT16 



IDA 

#0 



STA 

0C089,X 

;Reset the ACIA 


Set the Control Register 


IDA 

DCB+1 

; Fetch the bits per char 


SBC 


;Bus will set bit 4 (Internal Crystal) 


ROR 

A 

;Move bits 2,l,0,Carry, to 7,6,5,4 
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$10 


SSTAT 


ROR 

A 


RDR 

A 


ROR 

A 


ORA 

DCB 

;Add the Baud Rate info 

STA 

0C08B,X 

;Set the Control Register 

Now the Conttand Register 

IDA 

CLC 

DCB+2 


ROR 

A 

;Move 2,1,0 to 7,6,5 

ROR 

A 


ROR 

A 


RDR 

A 

;Move Parity Bits in place 

ORA 

*0A 

.•Disable Transmit Interrupt, not RTS low 

STA 

0C08A,X 

; Write cut Command Register 

ORA 

*1 


STA 

0C08A,X 

;Toggles Enable bit, and leaves it on 

LSR 

SENDING 

; Enable Running Flag 

IDA 

0C088,X 

;Clear rubbish from read register 

IDA 

DCB+3 


ISR 

A 


BCC 

$10 

;Not ENQ 

IDA 

DCB+4 


STA 

0C088,X 


IDA 

*0 


STA 

RTS 

ENQBUF 

.•Clear ENQ block counter 

Serial printer Status 


On Exit Carry set if car 

i trananit 

A has error Code 


IDX 

SIDT16 


IDY 

TYA 

0C089,X 

;Read the Status Register 

AND 

#7 

.-Check for Errors 

HEQ 

$15 

;Skip if no errors 

AND 

#4 


BEQ 

$10 

;Not over-run, so error exit 


Over-run error occurs vrtien a second character is received 
before the character in the Receive buffer can be read 
This results in the second and subsequent characters 
being discarded. When this error occurs, we shall read the 
register, and for the 380N/5OFF protocol, swap the character 
read for the one which was expected i.e. the character vrtiich 
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would have followed it. 

This alleviates the problem vhich 


arises when the CPU is busy reading fran a file at the same time 


as the Printer attempts 

to halt or re-start character 


transmission 




IDA 

0C088,X 


;Fetch the Character 


AND 

#7F 




BIT 

DCB+3 


;Test the Protocol 


HPL 

$20 


;Do not swap unless XDN/XDFF protocol 


CMP 

DCB+4 


;Is it XDFF? 


ENE 

$05 


;No, try for XDN 


IDA 

DCB+5 


;Yes, so use XDN instead 


BCS 

$20 


;Branch Always 

$05 

CMP 

DCB+5 


;Was it 34DN after all? 


BNE 

$20 


;No 


IDA 

DCB+4 


;Yes, so use XDFF instead 


BCS 

$20 


;Branch Always 


Error 

Exit 



$10 

JJR 

SINIT 


;Re-Initialize the ACIA 


IDA 

#30 


;Exit with Error Code 

} 

RTS 




$15 

Tfh 





AND 

*8 


;Test Receive Buffer 


BEQ 

$40 


jReceive Buffer is Qipty 


Handle character 

in Receive Buffer here 


IDA 

0C088,X 


;Read the Char 


AND 

#7F 


;Mask the ms bit 

$20 

STA 

RECBYT 


;Save Receive Buffer Contents 


IDA 

DCB+3 


;Chedc Operation Type 


BHE 

$25 


;XCN-XOFF protocol 


ASL 

A 




BMI 

$45 


;Hardware Handshake 


EOR 

*2 


;Test for ENQ/ACK 


BNE 

$50 


;Undefined or no Protocol 


Handle ENQ/ACK here 



IDA 

ENQBUF 




BNE 

$50 


;Buffer is set, normal exit 


IDA 

RECBYT 




CMP 

DCB+5 


;Is received Char ACK? 
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ENE 

$60 

no, have not received ACK 


IDA 

DCB+6 

ACK received, so 


STA 

ENQBUF 

Initialize the Buffer Count 


BCS 

$50 

and exit 


Handling JEN/lOFF here 


$25 

IDA 

RBCBYT 



CMP 

DCB+5 

;Check if can turn transmission on 


BNE 

$30 

;Not XDN received, check for XDFF 


a C 


(JON received, so enable Transnissicn 


BCC 

$35 

(Now Check if Send Buffer Free 

$30 

CMP 

DCB+4 

;X)FF received? 


ENE 

$40 

;No, so skip 


At this point, Carry is set if ADFF received 



reset if MDN received 


After 

the next instruction, Carry moves to Hi bit of SENDING 

$35 

RDR 

SEUJING 

; Set/Reset XDN/5CFF state flag 


Canes 

here if no char read, or 5CN/5DFF protocol and char read 

$40 

BIT 

SENDING 

•Check if XDN-XOFF inhibition 


BMI 

$60 

(Inhibited, so exit with Carry Cleared 


BIT 

DCB+3 

(Check if Hardware Handshake 


BVC 

$50 

(No, so Check if Send Buffer free 


Hardware handshake goes here 

$45 

TXA 




AND 

#60 

Check if Receiver still there 


ENE 

$60 

•Lost Receiver 


Normal Test of vtether Transnit Buffer full 
(Always performed unless SDEF received) 

$50 

TXA 




AND 

#10 ;Check Transmit Buffer Full 


EBQ 

$60 

Skip, Transmit buffer full 


If waiting for ACK and Send Buffer free, then send ENQ 


IDA 

DCB+3 



LSR 

A 

Check if ENQ protocol 


BCC 

$55 

No, so branch 


IDA 

ENQEUF 

Send Buffer Free? 


BNE 

$55 

Yes, branch, ACK received 
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IDA 

DCB+4 



STA 

0C088,X 

;Send ENQ character 


BCS 

$60 

;and take busy exit 

i 

i 

Free to 

Transmit exit point 

$55 

SBC 


;Can transmit, so set Carry Flag 


.BYTE 

90 

;B0C (never taken) skips next byte 

i 

t 

Busy exit point 


$60 

CLC 


;Clear Carry, as busy 


IDA 

*0 

;No Error 


RTS 



SENDING 

.BYTE 

0 

; Flags State of XCN-XDEF txansnissicns 

REEBYT 

.BYTE 

0 

r Torpor ary save of read byte 

ENQBUF 

.BYTE 

0 

;Count of chars to send under ENQ/ACX 

• 

f 

f 

Write char to the printer 

On entry Char to be written is in A reg 

SWRIT 

IDX 

SL0T16 



STA 

0C088,X 

;Send Character to Transnit Buffer 


IDA 

ENQBUF 

;If ENQ Buffer already zero, do nothing 


BEQ 

$10 



DEC 

ENQBUF 

;Decrement Buffer Count for BNQ/flCK 

$10 

RTS 




.END 



17.4 

Apple Pascal 1.1 

Generic Driver 


Many of the more recent Interface Cards support a 
standard protocol for linking to Pascal 1.1. For this to be 
the case, the card must provide entry points for: 

Initialization 
Status Check 
Read a Character 
Write a Character 

The Generic Driver (Listing 17.4.1) determines the Pascal 
1.1 entry points, branches to the appropriate firmware 
routine with the correct register contents, and adjusts the 
Status, and A Registers before returning to Stemwriter. 
This Driver assumes that the firmware will make use of the 
following Zero Page locations: 
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$26 

SL0T16 


$27 

CHARACTER 


$2A 

Temporary 

Storage 

$2B 

Temporary 

Storage 

$35 

Temporary 

Storage 


The Driver saves the contents of these locations, restores 
the values last used by the Driver, executes the Driver 
task, saves the cell values for next time, and restores the 
values at entry, before returning to Stemwriter. The above 
locations are used by the Super Serial Card. Other devices 
may use different locations, necessitating slight changes in 
the Driver coding. 

17.4.1 Generic Pascal 1.1 Driver Listing 


****************************************** 


** 

Generic Pascal 1.1 Card 

** 

** 

Driver Software 

** 

** 

Copyright (C) 1984 

** 

** 

TM Systems Consultants Pty Ltd 

** 


****************************************** 


This is the Generic Pascal 1.1 Driver which uses the 
Pascal 1.1 entry points for Writing, Initialization, and Status 

This Listing is for assembly by the Apple /// Pascal 
Assembler. After Assembly, the Code File has to be 
passed through the SOS Utility MAKEINTERP, supplied with 
the SOS Reference Manual, to produce a Binary File. This 
program discards the first and last blocks of the file. 

With very minor changes to seme mnemonics, this 
source code can be assembled by the ProDOS Assembler, to 
directly produce the required Binary File. 


Device Driver starts here 

.ABSOLUTE ;Pascal Assanbler Initialization 

.NOLIST 

.PROC GENERIC 

.ORG 1EOO ;Absolute Starting Address 
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; Configuration Table Equates 

SL0T16 .EQU 4140 /Slot * by 16. 

DCB .EQU 4141 ;Device Configuration Block 

/ (Unused by the GENERIC Driver) 


Memory Cell Swap Macro 
Uses X,Y registers 

Contents of cells %1 and %2 are swapped 
A register is unaffected 

A Typical call is: SWAPS AVAL.B/AL 


.MACRO 

SNAPS 

IDX 

%1 

IDY 

%2 

STX 

«2 

STY 

%1 


.ENDM 


Eiitry 

points for links 

to Steiwriter 

JMP 

SINIT 

; Initialization despatcher 

JMP 

SSTAT 

;Status Despatcher 

JMP 

SWRIT 

.•Writer Despatcher 

Generic Pascal Device 

Initialization 

IDA 

SL0T16 

;Fetch Slot Number *16 

LSR 

A 


LSR 

A 


LSR 

A 


ISR 

A 


ORA 

#OCO 

.-Created Hi Byte of Address of Slot 

STA 

CSIOT 

;and save it 

STA 

$05+2 

;Set Hi byte of address for Entry Points 

IDX 

*3 


IDA 

0C10D.X 

;Fetch Lo byte of Entry Address 

STA 

DEX 

INILO,X 

;and save it 

BPL 

$05 


IDX 

INIIO 

;Lo byte of initialization address 

JMP 

GENEX 

/Execute the Generic Task 
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INIIO 

.BYTE 

0 

;Initialization Lo Byte Address 

RDIO 

.BYTE 

0 

;Read Lo Byte Address 

wmo 

.BYTE 

0 

;Write Lo Byte Address 

STIC 

.BYTE 

0 

;Status Lo Byte Address 


Perform the Status Check 


Status 

on exit zero if no error 


A reg 

has error number on exit 


Carry Set if free to accept input 

SSTAT 

IDA 

#0 

;Ready to accept Data? 


IDX 

sno 



JSR 

GENEX 

;Generic Executor 


TAX 




BEQ 

$05 

;Test if Error encountered 


IDA 

#30 

;Exit with Printer Error Code 

$05 

RTS 



7 

7 

Write To the Card 


7 

On entry, A reg has byte to be written 

SWRIT 

IDX 

wmo 


7 

7 

Falls 

into the Generic Executor 

7 

• 

t 

Generic Executor 


7 

On Entry X reg has 

Lo byte of execution address 

7 

CENEX 

STA 

0CFFF 

;Throw out all C800 ROM 


STX 

KBYTE 



JSR 

SWAPZP 

;Save Zero Pages 


IDX 

CSIOT 

;Prepare X,Y regs for Pascal 1.1 Call 


IDY 

SIOT16 



.BYTE 

20 

;JSR ccnmand 

IOBYTE 

.BYTE 

0 

;Lo byte set up on entry to GENEX 

CSIOT 

.BYTE 

OCO 

;Hi byte set up at Initialization (Cs) 


TXA 


;Place Error Byte in A Register 


The routine falls into Zero Page Saver 


Save Zero Page Entries used by Super Serial Card 
when using Pascal 1.1 (Same as for other cards?) 
A register is unaffected 


SWVPZP SWAPS 
SWAPS 
SWAPS 
SWAPS 


026,$100 
027,$100+1 
02A, $100+2 
02B,$100+3 
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SWAPS 035,$100+4 
RTS 
i 

; Save the Zero Page Data Here 

$100 .BIOCX 5,0 

.EX) 

17.5 Binding a Driver to Stemwriter 

Binding a Driver to Stemwriter is very simple. All 
that is needed is to assemble the Driver listing, and save 
it as a binary file named STEM.DRIVER on the Stemwriter boot 
diskette. During initialization, Stemwriter will search for 
this file, and load its contents into the memory, commencing 
at location $1E00. That is all there is to it. 
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18.0 ERROR HANDLING 

When errors in execution are encountered, the current 
process is halted, and the appropriate error message is 
displayed in the Command line. Most errors require that the 
current process be terminated, and tried again. Some errors 
result from the checking before execution of Command Line 
requests. For example, attempting to access a file or 
document currently being printed. 

In all, over 57 error conditions are tested for, and 
the appropriate action taken. The error messages are listed 
in Table 18.1 


Table 18.1 

Stcmwriter Error Messages 

Undefined Error 

Resources Unavailable 

Device Write-Protected 

Diskette Switched 

Pathname Syntax Error 

Too many Block files open 

File System Error 

Path not found 

Volume not found 

File not found 

Duplicate file name 

Directory full 

Volume full 

Not allowed this file 

Busy File 

Directory Error 

Not ProDOS Volume 

Full MemorysMust save Docs 

Too many open files 

Duplicate Volume 

Over 4 Super/Subscripts 

Wrong file type 

File Exists-Use Save 

Not Segmented File 

Not all Segments Exist 

Entry error at Underline 

Must Cut Text First 

Not enough free Tabs 

Illegal Tab Char 

Tab not Set 

Adjustment Impossible 
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No Match Found 
Not all Matches Found 
Error in Marker Position 
Marks not in same Doc. 

Null Text Field 

Column Operation Error 

Duplicate Document Usage 

Doc. not opened 

Page No. not in Head/Foot 

Line too wide 

Sorry-Wrong Password 

Document is Locked 

Field already in this State 

Sorry-Special Text Field 

Sorry-Protected Field 

Bad Date-Try Again 

Memory almost full:FINISH NOW 

Fatal Memory Error 

Not Enough Memory to Execute 

Illegal when Formatting 

Fields Overflow 

Forbidden-Formatted Doc. 

Printer Error 

Illegal when Printing 
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PART 4 

THE UTILITIES 

1.0 INTRODUCTION 

In contrast to Stemwriter itself, the Utilities program 
is controlled by means of a series of hierarchial menus. 
The options at each menu level are selectable with the up, 
down arrows to move the ">" character adjacent to the option 
required, and then pressing RETURN to accept that option. 

The Menu level currently selected is shown at the top 
of the screen, and helpful information is displayed at the 
bottom of the screen. One can escape, when indicated, to a 
higher menu level by pressing ESCAPE. 

The Utilities program is written in Assembly Language, 
and follows the Apple Pascal 1.1 conventions for keyboard 
usage, and screen display. 

1.1 The Master Level 


At the Master Level, one is presented with the Menu 
options: 

: Initialization 
: File Management 
: Sort/Select Segment Records 
: Word/Sentence Count 
: Labels 
: Exit Program 

The Initialization option permits one to pre-set the 
initialized state of Stemwriter, such as selection of 
printer driver. Abstract Printer Configuration Table 
settings, initial User Definable Key entries, and so on. 
The setting of these options is discussed in detail in 
Chapter 2. 

The File Management option provides Utilities for 
creating stock-standard text files (i.e. files with no 
embedded formatting or printer directive characters), 
copying and combining Segmented Files, and formatting 
diskettes. 

The Sort/Select Segmented File option permits the 
segments within a Segmented File to be re-organized 
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according to pre-defined keywords. For example, the Sort 
option permits the ordering of the segments in a file in 
ascending or descending order with respect to a nominated 
sorting key. The Select option permits the selection of 
those segment records which meet a desired criterion, for 
inclusion in a new segmented file. 

The Word/Sentence counter counts the words and 
sentences in a file. In addition, it reports the average 
number of characters in a word, and the average number of 
words in a sentence. These statistics may give a warning 
that clarity of expression is suffering, if the averages of 
word size, and words per sentence are high. 

The Labels Option permits the organization of segments 
in a form suitable for the printing of label stickers. A 
typical use would be for the preparation and printing of 
address labels. 

1.2 Organization of the Utility Programs 

The Utility programs are provided on the Stemwriter 
program diskette, and consist of a small 'root', or master 
scheduler program, and five overlays, one for each option on 
the Master menu. Each overlay occupies a binary code file, 
as follows: 


File name 

Contents 

UTILITY.SYSTEM 

Utilities Master Scheduler (root) 

CONFIG 

Initialization & Configuration Tables 

FILES 

File Management 

SORTS 

Sort/Select operations 

WORDS 

Word/Sentence Counter 

LABELS 

Label Printer 


If required, this suite of files may be copied to a 
separate disk, and executed from there. If the LABELS 
option is required with direct printing of labels, the files 
STEM.CONFIG, and STEM.DRIVER will need to be copied also. 
Provided that UTILITY.SYSTEM is the first SYSTEM file on the 
copy diskette, the Utilities will automatically be invoked 
when the copy diskette is booted. 

Control may be transferred to the Utilities from within 
Stemwriter, by exercising the 'Swap Interpreters' option. 
To do this from Stemwriter //, press Control-B, to display 
the command line: 
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Change Interpreters <esc>Y/N : 

Answer with 'Y', and then respond with firstly the Volume 
Name of the diskette holding the Utilities, and then the 
name of the Utility root program, UTILITY.SYSTEM. 

When control is transferred from Stemwriter to the 
Utilities, the entire memory contents of Stemwriter are 
lost. Therefore, before taking this step, ensure that all 
required documents held by the Stemwriter program have been 
saved as files. 

1.3 Number Representation 

We are all familiar with decimal numbers, that is, 
numbers to a base of ten. Such numbers are represented by 
the digits 0 to 9. With computer systems, other number 
bases are frequently used, in particular, binary and 
hexadecimal numbers. To understand how numbers in 
unfamiliar bases are built up, consider the decimal number 
147. This is really the number 1x100+4x10+7. Thus, 
remembering that the base of a decimal number is 10, this 
representation generalises to: 

digit x base x base + digit x base + digit 

The Utilities program frequently expects to receive 
numbers represented in hexadecimal notation. That is, 
numbers represented to a base of sixteen. We represent the 
individual digits by the digits 0 to 9, and then the letters 
A to F. Thus, the number OF hexadecimal is the decimal 
number 15. Hexadecimal notation is a compact way of 
representing numbers, which relates to the binary 
representation actually used by the computer (sixteen is an 
exact power of two). In fact, all the values which a byte 
can take on can exactly be represented by a two-digit 
hexadecimal number. Some correspondences between 
hexadecimal and decimal numbers are: 


Decimal Notation 

Hexadecimal Notation 

32 

20 

65 

41 

128 

80 

255 

FF 

256 

100 

2048 

800 

4096 

1000 


(the letter "A") 
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2.0 STEMWRITER INITIALIZATION 

When selected, this option presents the sub-menu: 

: Select Printer Driver 
: Configuration Tables 

By exercising each option in turn, Stemwriter may be 
configured to exploit the attributes of your printer to 
maximum advantage. 

2.1 Select Printer Driver 


Stemwriter expects to communicate with the installed 
printer in a standardised, uniform way. Unfortunately, 
there is a great variability in the way that the hardware 
and firmware on the many available Apple // printer 
controller cards works. For example, the Apple Parallel 
Interface Card firmware will not support background 
printing. Therefore, Stemwriter communicates with the 
installed printer via a printer driver, whose job it is to 
conceal these differences. Three standard drivers are 
provided in the sub-directory DRIVERS on the Stemwriter 
program diskette. These are: 

PARALLEL.DRIVER Use with Apple Parallel Interface 

Card 

SERIAL.DRIVER Use with Super Serial Card (//e) 

built in Serial Card (//c) 

GENERIC.DRIVER Use with any Card obeying Pascal 

1.1 protocols 

For further details on writing printer drivers, and the 
listings of the provided drivers, refer to the Reference 
Section, Chapter 17. 

When the Install Printer Driver Option is invoked, one 
is asked: 

Install Driver : 

One then supplies the pathname to the required driver, like 
so: 

Install Driver :/STEMWRITER/DRIVERS/PARALLEL.DRIVER 
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The destination directory for the driver is then requested, 
with the suggested Volume Directory /STEMWRITER as the 
target: 

Install Driver :/STEMWRITER/DRIVERS/PARALLEL.DRIVER 
in 

Directory :/STEMWRITER 

One may backspace to destroy the suggested Volume Directory, 
and re-type an alternative. On acceptance of the Volume 
Directory, a copy of the selected Driver is installed as the 
active Driver STEM.DRIVER in the nominated directory. 

2.2 The Configuration Task 

The Configuration Tables, in brief, pre-set some of the 
features of Stemwriter, and also tell Stemwriter how to 
control the installed printer. It is from the data in these 
tables, that the Abstract Printer determines the actual 
character sequences needed to make the printer perform the 
requested operations. 

When selected, this task first requests the pathname of 
the Configuration Table to be edited. The sub-directory 
CONFIG.TABLE on the Stemwriter Program diskette contains 
pre-configured Tables for a variety of printers. The active 
Configuration Table is called STEM.CONFIG, on the Stemwriter 
Program Diskette. A valid pathname to the desired Table 
must be entered, or an error results, and the information is 
re-requested. Once the Table has been selected, and loaded, 
one is free to choose from the menu: 

:Edit User Definable Keys 
:Edit Printer Attributes 
:Enter Overlay Prefix 
:Edit Paper Sizes 
:Edit Character Code & Size 
:Define Shape of Aux. Char Set 
:Edit Printer Control Table 
:Save Edited Parameters 

To prevent accidental loss of work done in updating the 
Configuration Tables, the question: 

Escape without Saving Y/N: 

is asked if an attempt is made to escape to the next higher 
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menu level without saving the new Configuration Table 
settings. 

The Options for setting the Configuration Tables will 
now be considered in turn; 


2.2.1 Set User Keys 

Selecting this option from the Configuration Tables 
Menu displays the following; 

Edit User Key:C 1 

< >[ 1 

:All Keys 

individual Keys 

The cursor will be initially resting against one of the 
editing options. "All Keys" signifies cycling through all 
the keys, while "Individual Keys" permits one to nominate 
the actual key to be edited. The option desired is selected 
by moving the cursor adjacent to the option, and then 
pressing RETURN. 

When the cursor is in the upper square box, entry of 
the key letter (A to J) is permitted. When a letter has 
been given, the User Definable character string associated 
with this key will be shown, with the number of characters 
in the <> brackets, and the characters themselves in the [ ] 
brackets. For clarity only, each character shown is 
separated by the <SPACE> character. Editing is effected by 
moving the cursor with the right or left arrow key to the 
character in question, and entering the new character. The 
edited string of characters is accepted by pressing RETURN. 
When this is done, all characters, from the cursor position 
onwards are deleted, and no longer form part of the 
definition. Thus, characters can be overtyped, there is no 
rubout, and only those characters to the left of the cursor 
are accepted. 


The following applies to character entry: 


Unmodified character 
Open Apple with printing keys 
Closed Apple with keys A to J 
Open Apple top row 
Closed Apple top row 


Standard Character 
Auxiliary Character 
User Key 
System Key 
System Key 
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Each User Definable key may have up to 31 (decimal) 
keypresses associated with it, consisting of standard and 
auxiliary characters. User Keys, and System Keys. When a 
User Key is encountered, control passes to the new User Key, 
and all characters following that point in the original User 
Key definition are ignored. Therefore, a User Key should 
appear in the definition of another User Key as the last 
character only, for the purposes of chaining User Keys 
together. 

Note : care must be taken in entering User Keys within 
User Key definitions, that an infinite loop is not set up. 
For example, suppose the definition of User Key A included 
User Key B, which in turn included User Key A. Pressing 
User Key A in this case, will cause the keys A and B to be 
alternately activated until the entire memory of the 
computer is filled with successive copies of keys A and B. 
This process is called Recursion. Should this happen, press 
Control-Q to halt execution of the User Definable Keys. 

During start-up, Stemwriter initializes User Key D to 
provide the current date in the format: 

January 26, 1988 

This initialization supplants any prior setting. 

The Utilities program uses the standard Apple character 
set in ROM. Therefore, auxiliary characters and some system 
keys will not display as expected when editing the initial 
User Key settings. Never fear, Stemwriter will recognize, 
and show the characters correctly. 

2.2.2 Edit Printer Attributes 


This table of information tells the Abstract Printer 
some of the properties of the installed printer. The Menu 
looks like this: 



00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

0A 

0B 

OC 

0D 0E OF 

00 

10 

[10] 

00 

00 

00 

00 

00 

00 

00 

20 

80 

04 

05 

06 

80 


The square brackets!] enclose the status byte currently 
being edited. It may be moved by pressing the arrow keys, 
until the desired byte is enclosed. The desired value is 
then entered, and accepted with RETURN. The brackets 
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automatically advance to the next byte. Entries are in 
Hexadecimal notation. Illegal entries are ignored, the bell 
sounds, and the brackets advance one byte. 

The usage made of the fourteen (00 to 0D hex) printer 
configuration bytes is as follows: 

Byte 0 Slot containing Printer Control Card, as 

per the following table: 

Slot Byte Value 

1 10 (hex) 

2 20 (" ") 

3 30 (" ") 

(and so on) 

Bytes 1 to 7 These are Device Configuration Bytes which 
are used by the specific installed Printer 
Driver. Their use is Driver Dependent. If 
you are using one of the standard drivers, 
refer to Chapter 17 of the Reference Section 
of this Manual for details. Otherwise, the 
use of these bytes is as you have determined. 

Bytes 08 to 0D These bytes are used to inform the Abstract 
Printer of specific features of the printer 
being used, as follows: 

Printer Configuration Bytes 

Usually, printers which accept a line of text, and only 
print when the RETURN or LINE FEED command is given, clear 
all or most special conditions at the same time. Daisy- 
wheel printers have to be halted to change the daisy-wheel, 
when effecting a change of font style. Some printers can 
advance fractions of a character by adjusting the Horizontal 
Motion Index (HMI), which is the amount advanced by the 
printer carriage after printing a character. For these 
printers, horizontal motion for microspacing is effected by 
adjusting the HMI, printing a <space>, and then restoring 
the original HMI. Other printers have commands which 
directly print fractions of a space. The significance of 
the bytes is as follows: 
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| Uline | Regen | Hfont | HMI | | Para | | Bold | 


Uline : 1 Double Strike for Underline 

0 Printer sends underline on, off characters 

Regen : 1 Printer selected options cancelled by <return> 

0 Printer selected options not cancelled by <return> 

Hfont : 1 Halt for change of Font Style 

0 Do not halt for change of Font Style 

HMI : 1 Use Horizontal Motion Index to define Microspace 
0 Do not use HMI 

Para : 1 Advance one line on New Paragraph 
0 Advance two lines on New Paragraph 

Bold : 1 Double Strike to make Bold Print 
0 Do not double strike for Bold 



| Cont | Cut | 


Cont : 1 Can handle Continuous paper 

Cut : 1 Has cut sheet feeder 

0 Can handle Single Sheets 

The setting of this Byte also effects the initialization of 
the Stemwriter default printer Command Line data. 

Byte OA Microspace for 15 pitch 

Byte OB Microspace for 12 pitch 

Byte PC Microspace for 10 pitch 

Byte 0D 80 if Microspacing available 

Define char size for another pitch otherwise 
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Bytes OA,OB,OC represent the microspace size of the 
<space> (or any other) character for the font sizes 15,12,10 
chars per inch respectively. This information is used to 
calculate line breaks, the amount of microspace to be used 
to fill out a line to obtain smooth left and right margins, 
and to check on print head horizontal position on the page. 
When Byte 0D has a value of 80 hex, the character sizes are 
drawn from the Character Size Table, and the Abstact Printer 
'fills' by evenly distributing space fractions when making 
an even right margin. For any other value, whole space 
increments are used for filling. 

The information to set these bytes will be obtainable 
from the specifications of the printer. For ready reckoning 
purposes in coding these bytes, refer to Table 1. 

Table 1 

Correlation between Bit Map and Hexadecimal Code 


Bits 


Bits 

Hex Code 

7 6 5 4 

Hex. Code j 

1 7 6 5 4 


0 0 0 0 

00 

0 0 0 1 1 

10 

0 0 10 

20 


30 

0 10 0 

40 


50 

0 110 

60 



10 0 0 

80 

10 0 1 


10 10 

A0 


i B0 

110 0 

CO 

110 1 


1110 

E0 

1111 

F0 


2.2.3 Enter Overlay Prefix 

In implementing the Stemwriter for the Apple //, it was 
decided to retain all the features of Stemwriter for the 
Apple ///. Consequently, the program, with its file 
buffers, data tables, virtual memory pages, and memory- 
mapped screen display, is too large to fit within available 
space in the Main Memory map left vacant by ProDOS, and the 
device slots. To overcome this problem, a technique known 
as overlaying, has been used. Stemwriter consists of a 
large, permanently memory-resident 'root', containing the 
bulk of the Editor, and the File Input/Output procedures, 
and four small 2k byte overlays, each sharing the same 
portion of the memory map, to provide less frequently used 
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functions. The overlays are kept as code files, and are 
copied into memory when required. Clearly, procedures in 
one overlay are unable to reference procedures in a 
different overlay. 


The organization of Stemwriter overlays is as follows: 


Overlay File Name 

Description 

STM.00 

Form better Generation, Line and 


Column Alignment 

STM.01 

Printer Commands 

STM.02 

File Housekeeping Commands 

STM.03 

Formatting Commands 


The overlay files are originally provided on the 
Stemwriter program diskette, but may be moved to any 
convenient location. Consequently, Stemwriter must be 
informed of their whereabouts, so that they may be fetched, 
when needed. This information is provided by entering in 
the Stemwriter Configuration Table, the pathname prefix to 
the location of the four overlay files. 

If the prefix is set at /RAM, the overlays are copied 
to the RAM-Disk during the initialization of the Stemwriter 
program, and drawn from there when and as required. This 
permits convenient operation in a single-disk environment, 
at the cost of reducing the Stemwriter workspace by about 8k 
bytes. 

If an alternative prefix is given, Stemwriter searches 
for the required overlay, and, if it can't find it, displays 
the message: 

Insert Overlay Disk & Try Again? <esc>/Y/N : 

This gives an opportunity to place the necessary diskette on 
line, if it had previously been taken off-line, and try 
again, by pressing ' Y' . Pressing <escape> or ' N' , will 
terminate the attempt to execute that task. 

To reduce wear-and-tear on your valuable program 
diskette, it is recommended that you either: 
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s Set the overlay prefix to /RAM 
or 

: Copy the overlay and utility files to a separate 
work diskette, and provide the appropriate prefix in 
the Configuration Table 

When Stemwriter is first booted, Overlay STM.00 is made 
available, to provide the full Editor and File Load/Save 
capability at the outset. 

2.2.4 Edit Paper Sizes 

When this menu is selected, the options shown are: 

: Metric Sizes 
: Inch Sizes 


One is thus able to choose the units in which the paper 
dimensions are entered. When the selection is made, the 
further menu appears: 



Width 

Length 

A 

[ 8.267 ] 

11.000 

B 

8.267 

11.692 

C 

8.267 

11.000 

D 

16.667 

11.000 


The desired paper dimensions are entered, against the 
letters A,B,C,D. These will then be the paper sizes 

referred to by the Stemwriter Command lines, and used by the 
Formatter. The number bracketed by the square brackets is 
the one to be edited, and can be selected by the arrow keys 
(up, down, left, right). 

2.2.5 Character Code & Size 

Selecting this option displays the menu: 

:Character Code Table 
:Character Size Table 

The Character Code Table is a look-up table which 
converts the ASCII code used by Stemwriter to the actual 
code used by the printer. Most printers use the ASCII 
character set for the standard characters in the code range 
20 hex to 7F hex, but may use printer-specific codes for 
special (and useful) characters represented by codes AO hex 
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to FF hex. A few printers may use a character code other 
than ASCII. Setting this table allows one to standardise 
character representation within Stemwriter files, and 
convert to printer-specific codes at print time. The 
Character Code conversion table is particularly useful for 
co-ordinating character screen display with the printed 
character, for the Auxiliary, or extended character set. 


The Character size table is the proportional spacing 
table, and carries the units of microspacing allocated to 
each character. This table is used in calculating line 
break position when the proportional space font is selected. 
Independently of the table selected for editing, it will 
look something like this: 


| 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E OF 


00 

10 

20 


70 

80 

90 

A0 


F0 


20 [21] 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 

70*" 71."" 72* *73 74 75 76*'77 78 79 7A 7B 7C 7D 7E 7F 

AD A1 A2 A3 A4 A5 A6 A7 A8 A9 AA AB AC AD AE AF 

F0 FI F2 F3 F4 F5 F6 F7 F8 F9 FA FB PC ED FE FF 


The most significant digit of the ASCII code of the 
character to be converted or sized, refers to the row number 
(left column of figures), and the least significant digit 
refers to the column number (numbers across the top). The 
table entry at the row, column position is either the 
character sent to the printer, or the microspace size of the 
character whose code provides the row, column co-ordinates. 
The dummy entry above is part of an ASCII to ASCII code 
conversion table. The rows 00,10,80,90 are positions 
occupied by control codes, and cannot be set. The code AO 
is the 'sticky' space code, and will always cause the code 
for a <space> (code at 20 hex in table) to be sent to the 
printer, irrespective of the setting of this cell. 


The table entry currently being edited is the one 
bracketed by the square brackets. As each entry is updated, 
the brackets will automatically advance one column. They 


Stemwriter Initialization 








350 


Part 4 - The Utilities 


may also be moved to any desired position by using the four 
arrow keys. 

2.2.6 Define Shape of Aux. Char Set 

This option displays the shape maker menu. The 
instructions are shown at the top of the screen, and below 
the instructions appears: 

Character Code [Open Apple ] 

Character Map 


Auxiliary characters have codes in the range AO hex, to 
FF hex. When the key corresponding to the Auxiliary 

character is pressed, the corresponding character map is 
shown as a 7 column by 8 row matrix. Within this matrix, 
blanks are shown by a period, and a dot is shown by the 
character The cursor is positioned using the arrow 

keys, a dot is placed by pressing any printing key, and a 
dot is removed by pressing the space bar. A satisfactory 
character shape is accepted by pressing RETURN. Note that 
you may set shapes for the characters Open Apple 0 to Open 
Apple 9, but the corresponding character codes are 

recognized by Stemwriter as System keys, and not as 

Auxiliary Characters. 

If an illegal character code is entered, the bell 
sounds, and a new attempt at entry may be made. 

The Auxiliary characters for all supplied printer 
tables are set to provide the Greek character set, and some 
useful Math symbols. Where possible, the correct 

transliteration between Greek and Roman characters has been 
employed. Refer to Table 4, Chapter 2 of the Reference 

Section for the actual transliteration employed. 
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2.2.7 Set Printer Control Codes 

The Stemwriter Abstract Printer has its own set of 
control codes to which it responds as required by a 
Stemwriter print directive. Whenever the Abstract Printer 
receives or produces a control code, it looks up the printer 
control code table, finds a string of up to 4 characters, 
and sends them to the physical printer. By this means, 
there is no need to re-code the Abstract printer, or re¬ 
define control sequences in Stemwriter files, to accommodate 
the requirements of a physical printer. The Abstract 
Printer supports 64 control sequences, arranged in two 32 
sequence tables, called the Basic Command Table, and the 
Extended Command Table. 

The menu displayed in selection of the Set Printer 
Control Codes is: 


: Basic Commands 
: Extended Commands 


Irrespective of which is selected, 
displayed: 

the further menu is 

Logical Code 

Physical Code 

[ 1 

[ 1 


The Code displayed in the left column of Table 3 or 
Table 4 is entered as the Logical Code, and the code 
sequence corresponding to the command listed under the 
column labelled Description is entered as the Physical Code. 
All entries have to be in hexadecimal notation. The only 
restriction on Table entries, is that the first of the four 
numbers (maximum) in each Table entry must be less than 20 
hex in value. 

All 32 (decimal) Basic Commands are allocated, but many 
of the Extended Command table entries are available for 
further expansion. The Command Tables are summarised in 
Table 2 and Table 3. 
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Table 2 

Basic Caimand Table 

Table Entry Description 

00 . Null, not used 

01 . Select Print Color 0 

02 . Select Print Color 1 

03 . Select 6 lines/inch 

04 . Select 8 lines/inch 

05 . Rev. 1/2 Line Feed (Superscript) 

06 . Reverse Line Feed 

07 . Bell 

08 . Backspace 

09 . Select Print Color 2 

0A . Line Feed 

0B . Half line Feed (Subscript) 

0C . Select Print Color 3 

0D . Carriage Retum/Line Feed 

0E . Set Underline off 

OF . Set Underline on 

10 . Select 15 Char/Inch 

11 . Select 12 Char/Inch 

12 . Select 10 Char/Inch 

13 . Select Proportional Spacing 

14 . Move 1 Microspace 

15 . Move 2 Microspace 

16 . Move 3 Microspace 

17 . Move 4 Microspace 

18 . Move 5 Microspace 

19 . Move 6 Microspace 

1A . Move 7 Microspace 

IB . Move 8 Microspace 

1C . Move 9 Microspace 

ID . Move 10 Microspace 

IE . Move 11 Microspace 

IF . Move 12 Microspace 


Stemwriter Initialization 



































Part 4 - The Utilities 


353 


Table 3 

Extended Contend Table 


Code Description 

00 . Select Font Style A 

01 . Select Font Style B 

02 . Select Font Style C 

03 . Select Font Style D 

04 . Turn Super script off (Half Line Feed) 

05 . Turn Subscript off (Rev. 1/2 Line Feed) 

06 . Bold off 

07 . Bold On 

08 . Cancel Proportional Space 

09 . Initials A 

0A . Initials B 

0B . Initials C 

0C . Initials D 

0D . Select Bin #1 

0E . Select Bin #2 

OF . Load Cut Sheet 

10 . Select Auxiliary Character Font 

11 . Letter Speed 

12 . Draft Speed 

13 . Unallocated 


IF 


Unallocated 


2.2.7.1 Handling Superscripts And Subscripts 

For printers which support half line feeds and reverse 
half line feeds, these commands are used to give Subscripts 
and Superscripts. The Extended Table Commands 04 and 05 
must also be set, to half line feed, and reverse half line 
feed, respectively. 

For printers which superscript and subscript with half¬ 
height characters, Basic Command 5 receives the Turn 
Superscript On command, and Basic Command 6 receives the 
Turn Subscript On command. The Extended Commands 4 and 5 
become Turn Superscript Off, and Turn Subscript Off 
respectively. This setting precludes the production of 
1-1/2 line spacing, as the half line feed command needed is 
used as a Subscript On command. 
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Some printers do not support half line feeds, but do 
support reverse and forward line feeds, with a Vertical 
Motion Index adjustable in 1/48 inch increments. For this 
type of printer, half line movements are possible by the 
following artifice: set the 6 and 8 line/inch commands to 
correspond to a half-line. Then, the half and reverse half 
line feeds are coded for a single line movement, and the 
full reverse and forward line feed commands are set for a 
double line movement. If operating with a cut sheet feeder, 
it may also be necessary to adjust the lines per page as 
part of the Initialization Sequence. 

2.2.7.2 Initialization Sequence 

For some printers, it is desirable to send a sequence 
of initializing characters to the printer before printing 
commences. When the printer is first accessed for printing, 
the four command sequences 09 to 0C from the Extended 
Command Table are sent in order to the printer. Each 
sequence may consist of any legal ASCII character, with the 
proviso that the first character in each sequence must have 
a code value less than 20 hex (32 decimal). It is possible 
to fit two two-code commands in each sequence. In all, a 
maximum of 16 bytes may be transmitted to the printer for 
initialization purposes. 

Many printers do not need an initialization sequence, 
but some do. Examples of properties which can be set in 
this way include printer left margin, new line on carriage 
return, cancel skip over perforations, set top of form, and 
so on. The Initialization Sequence is always sent to the 
printer before the text of the document is printed, and when 
using the "[Advance] Printer to Page Head" command. 

When no initialization sequence is required, set all 
bytes of these table entries to zero. 

2.2.7.3 Select Cut Sheets 

Stemwriter will work with either single or dual-bin.cut 
sheet feeders. The use of a dual bin feeder allows one, for 
example, to use letter head paper for sheet 1 of a document, 
and plain paper for the remaining sheets. The command 
sequences which control cut sheet selection and loading, are 
the Extended Command Table entries 0D, 0E for bin selection, 
and OF for sheet loading. When the printer is first opened 
for printing cut sheets, a sheet from bin #1 is selected and 
loaded. All subsequent sheet loadings are then drawn from 
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bin #2. For single bin operation, one might set the bin 
selection commands to zero, and code only the sheet loading 
command. In any case, operation with a cut sheet feeder 
causes a new sheet to be loaded before printing commences. 
These entries are ignored unless the cut sheet option is 
selected for the printing of the Document. 

2.2.7.4 Proportional Spacing 

For those printers which support proportional spacing, 
there are some for which the selected proportional spacing 
must be cancelled before a new font size can be selected. 
For this type of printer, command 08 in the Extended Command 
Table must be correctly set. For those printers not 
supporting proportional spacing, or for which proportional 
spacing is automatically cancelled by selection of a 
different font size, set this entry to zero. 

2.2.7.5 New Line 

Stemwriter files expect the RETURN command to execute a 
RETURN/LINE FEED. Depending upon the printer, and its 
switch settings, the command 0D in the Basic Table may need 
to transmit the code for RETURN (0D), or RETURN/LINE FEED 
(0D 0A). 

2.2.7.6 Microspacing 

It is assumed that the microspacing increment will be 
either 1/60 or 1/120 inch per unit. The Abstract Printer 
selects which of these is appropriate by referring to the 
number of microspace units which correspond to a font size 
of 12 char/inch. This information is entered as part of the 
Printer Attributes Table. 

Printers which do not support microspacing are 
identified by the entry in the Printer Attributes Table for 
Proportional spacing. When microspacing is supported, this 
entry is 80 hex. Otherwise, the proportional spacing entry 
can be used to define any additional font size. 

For those printers which microspace by adjusting the 
Horizontal Motion Index, each microspace entry in the 
command table consists of the HMI adjustment command, 
followed by a <space>. If the HMI flag is set correctly in 
the Printer Attributes Table, the HMI is automatically 
adjusted back to its correct value before proceeding. 
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2.2.7.7 Letter or Draft Speed 

Some dot matrix printers are capable of printing at two 
speeds, viz; a high speed for draft documents, and a lower 
speed for letter quality documents. Auxiliary command 
sequences 11 and 12 hex should be set to contain the 
appropriate command sequences when the printer has this 
capability. For daisy wheel printers, these command 
sequences are not used, and should be set to zero. 

2.2.8 Save Attributes File 

When this option is selected, the file from which the 
data was loaded is suggested as the destination. If this is 
in order, then pressing RETURN is all that is needed. 
Otherwise, backspace to remove the suggested pathname, and 
enter the desired pathname. This is how a library 
Configuration Table is promoted to become the active Table, 
STEM.CONFIG. 
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3.0 THE FILE UTILITIES 

When this option is selected, one is presented with the 

menu: 


: Create Vanilla File 
: Copy Segmented File 
: Combine Segmented Files 
: Format a Diskette 

When more than one Volume is to be involved, these 
Utilities will require the use of two disk drives. 

3.1 Creating A Vanilla File 

A Vanilla File is a file which contains only printing 
characters, carriage return, and, optionally, line feed. 
All other non-printing characters are removed, conditional 
line breaks are converted to firm line breaks (carriage 

return), the new paragraph character is replaced by two 
carriage returns, and text enhancement directives (field 
indicators) are removed. 

Vanilla files are very useful for providing text to be 
sent to a typesetter, for transfer of text files between 
dissimilar word processors, and to prepare text for tele¬ 
transmission. 

The created vanilla file may be either an Apple /// 
Pascal text file, or a ProDOS text file (identical to an 

Apple /// ASCII file). For a Pascal Text file, the first 
two blocks are used for saving file housekeeping data. A 
ProDOS (ASCII) file, on the other hand, is the kind of file 
created when printer output is re-directed, and consists 
solely of the text. 

One is initially asked whether the new line directive 
is Carriage Return/Line Feed, or Carriage Return alone: 

Each <cr> followed by <lf> Y/N : 

Press Y or N to select, and accept by pressing <ENTER>. 

One is then asked for the type of the Vanilla file to be 

created: 


Vanilla is TEXT/ASCII File T/A: 

Press "A" to select an ASCII file, and "T" to select a Text 
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file (as defined above) to receive the resultant Vanilla 
text. Notice the message which then appears: 

Enter FULL Pathname for Source/Destination 

This is a reminder that no preset prefix is assumed by the 
program, and the full pathname must always be given. One is 
then asked for the pathname of the Source Document: 

Source File : 

When this has been satisfactorily entered, one is then asked 
for the destination document pathname: 

Destn File : 

On entry of this information, the operation proceeds. 

Messages may appear near the top of the screen from 
time to time, to signal errors, or to indicate that the task 
was successfully completed. 

Message : 

An error results if an attempt is made to create a "vanilla" 
version of an encrypted file. This error will appear as a 
"wrong file type" error. Pressing the <SPACE> bar when 
requested will return to the File Utilities Menu, from which 
further operations may be executed. One can return to the 
Main Menu by pressing <ESCAPE>, as indicated at the bottom 
of the screen. 

3.2 Copy Segmented File 

Stemwriter provides two alternative ways of moving 
Segmented Files from one place to another. The first way is 
to use Stemwriter itself, as follows: 

Load as many Segments as will fit to a Document 
Save the Segments with a new pathname. 

Clear Document and load remaining segments (if any) 

Add to new Segmented File 

Repeat until all Segments are transferred 

This approach is recommended when moving between Volumes 
when only one disk drive is available, or when only a small 
amount of text is involved. However, when moving a large 
Segmented File, this approach is slow, and cumbersome. The 
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Utility to move Segmented Files is designed to be used when 
large files are involved# or when creating the recipient 
file prior to appending the contents of a second file. The 
operations carried by this utility are as follows: 

Copy Text File 

Create New Segment Table File 

Update Segment Table Pathname saved in Text File Header 
Copy old Segment Table to New Segment Table 

It is not possible to use the standard File Utilities 
provided by Apple Computer for this purpose, as a clash 
between Segment Table Names may occur. 

As for the Vanilla File creation, one is first asked 
for the Source File pathname: 

Source File : 

and then the Destination File Pathname 

Destn File : 

Both The Source and Destination Files must have their FULL 
pathnames given. This Utility assumes that no Prefix has 
been set. This Utility will only work with unencrypted 
Files. An attempt to move an encrypted file results in a 
"wrong file type" message. When requested, pressing the 
<SPACE> bar will return to the File Utilities Menu, for 
further commands. One can escape to the Main Menu by 
pressing <ESCAPE> at any time. 

3.3 Combine Segmented Files 

This Utility appends the contents of a Donor File, to a 
Recipient File. The Recipient File is augmented by the 
contents of the Donor File, and the Donor File remains 
unaltered. When this option is selected, one is first asked 
for the pathname of the Donor File: 

Donor File: 

and then the pathname of the Recipient File: 

Recipient File : 

Both files must exist, and be segmented files. Otherwise, 
the appropriate error message is displayed. 
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This Utility is particularly useful when used in 
conjunction with the Select command, for building up new 
files of records meeting certain criteria. 

3.4 Format A Diskette 

Before a diskette can be used, it must be formatted. 
That is, special information must be laid down on the 
diskette, so that specific locations can be identified for 
the writing and reading of data. A good analogy is to 
consider the surveying of a new Suburb, and the creation of 
streets, and street numbers to uniquely identify each block 
of ground. The formatting information laid down on a new 
diskette performs a similar task. It identifies the unique 
block of data to be referenced. 

Thus, formatting a diskette serves a different purpose 
from formatting the text of a document. What they both have 
in common, is the ordering of information according to a 
pre-determined layout, or format. 

When the Format a Diskette command is selected, one is 
initially asked for the slot number associated with the 
drive to be used: 

Format medium in Slot : 6 

(Slot 6 is the suggested value.) 

When the slot has been identified, one is next asked for the 
drive number associated with that slot: 


Drive : 1 


(Drive 1 is the suggested drive number.) The medium 
installed in the nominated drive is then checked, to see if 
it already contains valid information. If it does, the 
question is asked: 

Destroy the contents of [/VOLNAME] Y/N : 

This gives you a chance to escape, and try again if you have 
inadvertently left a valuable diskette in the nominated 
drive. If you answer "Y" to the question, the information 
already on the diskette will be destroyed during the 
formatting process. Had you answered "Y" to the above 
question, or the diskette was truly blank, the next question 
asked would be: 
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With the Volume Name :/BLANKOO 

The names BLANKOO through to BLANK99 are suggested Volume 
names. To use an alternative, backspace to remove the 
suggested name, and then enter the desired name. 


The formatting process then starts, with the message: 


Message : 

Formatting. 


displayed 
change to: 

at the top of the screen. 

Soon, the message will 

Message : 

Initializing. 


to indicate that initialization data 
diskette. Finally, the message: 

is being written to the 

Message : 

Formatting Complete 

Press <SPACE> bar to continue 


will be displayed. On pressing the SPACE bar, the process 
is repeated. 
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4.0 SORT/SELECT SEGMENTED FILE 

When the Sort/Select option is selected, the following 
Menu is displayed: 

: Sort Segment Records 
: Select Segment Records 

The Sort/Select Utilities are very useful for 
maintaining records of textual data, such as address lists, 
reference lists, a file index, and so on. They also make 
possible the 'boilerplating' of documents on keyword, rather 
than on segment number. Both these Utilities make extensive 
use of the Comment Fields. Since Comment fields are not 
printed, and are ignored by the Stemwriter Formatter, they 
provide a convenient means of attaching a set of classified 
keywords to a segment. These keywords may then be used for 
the sorting and selection of records. Keywords are defined 
through the use of Classified Comment Fields. 

4.1 Classified Comment Fields 


A Classified Comment Field is a special-purpose comment 
field which consists of a classification, and a keyword. 
The Classification Word or Class Key, must occur immediately 
following the Comment Field On symbol, and is a collection 
of alphanumeric characters surrounded by angle brackets . 
The remainder of the Comment Field is then the associated 
keyword. This may be represented like so: 

—> <CLASS>keyword<— 

The angle brackets enclose the particular Class to which the 
following keyword belongs. For example, a reference list 
may contain classified comment fields looking like so: 

—XAUTHOR>JOHNSTONE4- -XTOPIOSOLAR ENERGttF- 

Here the Class <AUTHOR> is used to signify that the 
following keyword is the Author's name. Similarly, the 
second Comment Field contains the <TOPIC> of this Reference, 
which is Solar Energy. There is only one reserved Class, 
<ADDRESS>, which has a special meaning for the form letter 
process of the Stemwriter program. There are no other 
restrictions on the definition of Class Keys, or the usage 
of keywords. The only restriction on the placement or 
ordering of Classified Comment Fields in a segmented record, 
is that a field is not recognized unless it occurs within 
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the first 512 characters of the Segment. Thus, one has 
considerable freedom in designing the Class Keys, and 
keywords to be used with the segment records. Effectively, 
with the combined usage of Classified Comment Fields, and 
Segmented Files, one has free-form records of arbitrary 
size, which are filed, and can be retrieved, in a very 
efficient and simple way. 

4.2 Wildcard Keys 

The character * may be used as a wildcard designator 
for all or part of both the Class Key, and the keyword 
itself. For example, it may be that a particular paper has 
three authors, coded with Class Keys <AUTH0R1>, <AUTH0R2>, 
and <AUTH0R3>. Selection based on AUTHOR^ and the desired 
name, eg JOHNSTONE, will find papers authored by Johnstone 
whether or not he was the first, second, or third Author. 
Similarly, a search using the Class Key AUTHOR2, and the 
keyword * for the Name, will find all papers with more than 
one author. 

4.3 Sorting 

Suppose, in the preceding example, we wished to sort 
our reference list in ascending order of Author Name. We 
would specify that all keywords of class <AUTHOR> be 
extracted, and then used to re-order the segments in the 
file. When the Sort option is selected from the Menu, one 
is first asked for the pathname of the File to be sorted: 

SORT 

Source File: 

Using 

Class Key : - in Ascending/Descending 

Order : A/D: 

The screen progressively shows the preceding prompts as each 
new piece of information is requested. In this example, the 
Class Key is AUTHOR (without the parentheses), and the Order 
is A for ascending order, and D for descending order. The 
keywords from two or more Classes may be joined together 
(concatenated), to produce a "super" keyword. The maximum 
size of the sorting key is 40 characters. For example, if 
we wished to sort on AUTHOR, and then on the secondary key 
TOPIC, we would have entered: 

Class Key :AUTHOR#TOPIC 
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and the Sort keyword for this example would be 
JOHNSTONESOLAR ENERGY. 

The sorting algorithm used is the efficient "Heapsort". 
Heapsort has been chosen because its performance is 
independent of the initial ordering of the data, it makes 
efficient use of memory, and is second only to "Quicksort" 
in speed. This implementation has the capacity to sort 400 
records in memory, or up to 3000 records with a disk scratch 
area. The scratch area is organised as a virtual array, to 
conserve disk space, and the 400 record memory array is used 
as a cache. When a disk scratch area is required, the 
program requests the name of the volume upon which it may 
create a scratch file: 


Message : Too many keys for Memory Sort. Need Disk Space 


Use Volume : 

Irrespective of whether the sorting is done purely in 
memory, or by use of a disk scratch area, the original 
records remain untouched. It is the pointers in the Segment 
Table which are re-ordered. It should be borne in mind that 
as the number of records to be sorted increases, 
progressively heavier usage is made of the disk scratch 
area, with a corresponding degradation of performance. 
Typically, it takes about 10 seconds to sort 400 records, 
and an estimated 70 minutes to sort 3000 records using a 
disk drive for scratch (exclusive of time to build up the 
sort keys). The RAM-disk, /RAM will hold about 1300 record 
keys, and will be up to 10 times faster than using a 
diskette-based scratch area. 

4.4 Select Segmented Records 


This Utility permits one to scan a Segmented File, and 
extract all those records which meet certain criteria, for 
placement in a new Segmented File. For example, one could 
search for all references to Solar Energy, all references.by 
Author Johnstone, or all references by Author Johnstone on 
the topic Solar Energy. One is first asked for the Select 
Code: 


Select Code: 

At this point, one enters an equation involving the 
classification codes, like so: 
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A.B+C. D 


Which means, those records with keys in classes A and B, or 
C and not D. We must also specify the associated keywords 
for each class. This is done via the prompts: 


For 

Select Code : A 
Enter 

Keyword : 


In our example, if we had wanted the papers by Johnstone on 
Solar Energy, we would have specified the Select Code as: 

Select Code : AUTHOR.TOPIC 


and for the Code AUTHOR we would have entered JOHNSTONE, and 
for the Code TOPIC, we would have entered the keyword SOLAR 
ENERGY. When this information has been entered, one is then 
asked for the name of the file to be scanned: 

Source File : 

Scanning then commences, and when the first match is found, 
one is asked for the destination file to receive the matched 
records: 

Destn File: 

When the Selection is complete, the number of records 
scanned, and the number of matches found is reported. 

All papers by Johnstone on Solar Energy and Wind Energy 
would be found by specifying: 

Select Code : AUTHOR.TOPIC + AUTHOR.TOPIC 


The corresponding keyword for AUTHOR in both cases is 
JOHNSTONE, and the corresponding keywords for TOPIC are 
SOLAR ENERGY and then WIND ENERGY. The selection equation 
may involve up to eight elements. 
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5.0 WORD/SENTENCE COUNT 

This Utility counts the number of words and sentences 
in either a whole or segmented file, and reports: 

The number of words 
The number of sentences 
The average word size in characters 
The average sentence size in words. 


A word is defined by consecutive alphabetical characters, 
and the number of sentences are determined by counting the 
number of sentence delimiter characters, viz ""?", "!", 
and the New Paragraph character. 

When this option is selected from the menu, one is 
asked for the pathname of the file to be counted: 

Count Pile: 

This Utility is useful for Authors who are paid by the word. 
In addition, the average word and sentence sizes give some 
indication of potential problems with clarity of expression. 
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6.0 LABELS 

A frequent use for an address list, is to print 
adhesive address labels for the mailing of form letters. 
This Utility is intended for that purpose. One can create 
multi-column lists of addresses, properly organised for 
printing onto adhesive label sheets. The formatted labels 
may either be printed directly, or may be spooled to a whole 
file for subsequent printing as a background job whilst 
using Stemwriter. 

Before invoking this Utility, it is necessary to 
measure up the label sheets, and to specify the printer line 
spacing, and character size. (Typically 6 lines per inch, 
and 12 characters per inch). The horizontal measurements 
are converted into character spaces, and the vertical 
movements into line spaces. The following dimensions are 
required. 

The number of lines in a label 

The number of lines between labels 

The number of labels across a page 

The number of character spaces on a label 

The label left margin indent in characters 

The number of characters between labels 

It is assumed that the left edge of the leftmost label is at 
the first printing position of the printer. The above 
information defines a 'box' into which each label must fit. 
If a label is too large for its box, it is truncated. 

When all the above information is to hand, the Utility 

may be invoked. You are successively asked for the above* 
dimensions. When these are entered, one is then asked if 
the formatted labels are to be printed directly, or to be 
spooled to a text file. 

If the printing option has been selected, the printer 
carriage must be correctly aligned with the label sheets 

before proceeding further. One is then asked whether the 

printer requires Carriage Return, or Carriage Return/Line 
Feed to effect a new line of printing. Examination of the 
Printer Manual, and the appropriate printer switch settings 
will answer this point. Alternatively, a short dummy run, 
using scrap paper will provide the answer. 

The pathname of the Segmented File providing the 
addresses is then requested! 
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Source File : 

If the Printing option had been specified, then printing 
would start immediately. There is no counting or 
recognition of page breaks, and none of the printing 
enhancements provided by Stemwriter are available. If these 
enhancements are required, then the File option must be 
used, and the resulting file later printed by Stemwriter.. 

If the File option had been specified, then one is 
asked for the pathname of the file to receive the formatted 
labels: 

Destn File : 

The Global statistics for line spacing, character size, line 
width, and so on, which applied to the source file, are 
transferred to the destination file. The only exception is 
that the number of lines in the page heading and footing is 
always set to zero. If the line and character spacings used 
for the calculation of the label boxes are at variance with 
those pertaining to the source file, then the created file 
must be printed with the [new] data option, and the correct 
parameters selected. 

Because of the way in which the label boxes are 
defined, it is not possible to use proportional spacing for 
the printing of labels. 

A convenient usage of the Label printing utility is to 
use it in conjunction with the Record Select Utility to get 
a fast print-out of records meeting certain criteria. For 
this usage, specify one column of labels, with a label width 
of 80 characters. 
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THE ASCII CHARACTER SET 
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ON WORD PROCESSING 


When one is introduced to a stranger, a first impression of strength 
varying from instant like, through ho-hum, to instant dislike, is 
formed. This first impression is modified in the light of subsequent 
contacts, as less obvious facets of their character are highlighted by 
differing circumstances, and different times. Thus, our first 
impressions are shaped and moulded by subsequent experiences. 

As it is with people, so it is with software. The more 
functionally complex the software, the truer this is. First impressions 
couuc, but may be a poor indicator of our final impression at the end of 
the day. The cute features which first attracted our attention, may, 
with time, appear shallow, annoying, and unnecessarily restrictive. 

This cycle is particularly relevant to word processing software. 

There are many different ways, and for different purposes, that 
people wish to manipulate words, ranging from computer source code, 
through form letters, and the latest in steamy novels, to Nobel Prize 
winning papers. Consequently, the generic, intuitive, all-purpose 
program with a chameleon User Interface which adapts to the individual 
personality of the user, is highly sought after, but remains an elusive 
dream. However, below this level, great advances have been made, both 
in terms of the power to manipulate words and characters, and the ease 
with which this may be done. Several evolutionary stages have already 
been passed through, as shown in Figure 1. 


User Interface 

Question & Answer > Remember & Type > Recognize & Point > Listen & Print 
Figure 1 Stages in User Interface Design 


The first Editors were line oriented editors designed for the entry 
and manipulation of program source code on mainframe computers. The 
prime emphasis was on "getting the job done" - that is, providing the 
text manipulation features which made the handling of program source 
code easy. User interfaces were rudimentary, because the users were 
computer-literate, and got a "buzz" out of using obscure and arbitrary 
command sequences. Some editors developed to the ..stage of becoming 
pseudo-languages in their own right, such as TECO , which is capable of 
prodigious feats of text manipulation, but is as safe to use as a loaded 
rifle with a faulty safety catch. 

At some later stage, it was recognized that general computerised 
text editing had applications far beyond the narrow confines of editing 
and correcting FORTRAN and COBOL source code. Thus appeared the first 
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dedicated word processors. It was soon realized that the rudimentary 
user interfaces masochistically loved by computer sophisticates, cut no 
ice with people who did not know (or care) the difference between a bit 
and a byte. Consequently, a significant effort was put into the design 
of the user interface. 

Sadly for some, the day of the dedicated word processor was as 
short as the life of a mayfly in spring, as they were overtaken, and 
superceded by the cheaper, and more versatile microcomputer. Initially, 
text and word processing facilities provided on microcomputers were 
transported (philosophically and physically) from the mainframe and 
mini-computer worlds. Consequently, the same evolutionary path has been 
followed (Figure 1), with the user interface progressing from "Question 
and Answer" through to "Recognize and Point". We have still to reach 
the ultimate (or penultimate?) state of "Listen and Type". 
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Figure 2 Evolution of Operating 
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Concurrently with improvements in User Interface design, there has 
been a re-assessment of the whole operating environment. We started off 
with the'Ultimate in free-form, the pencil & paper, capable of putting 
arbitrary shaped marks anywhere at will, to the faster and more legible 
(but more restrictive) typewriter, to the strongly mode-oriented word 
processor. We are now beginning to see a breaking down of the mode¬ 
generated restrictions, as we drive full-circle towards the computer- 
aided free-form placement of arbitrary marks. Such is life. 

Steravriter represents one point in the continuum of User Interface 
Design, and Operating Characteristics. It has an advanced and intuitive 
User Interface, and mode-oriented operation has been almost entirely 
scrapped. It is therefore no accident that Stemwriter is "State of the 
Art" in both these areas. 

The earliest text editors had very rudimentary formatting 
capability. In contrast, the text formatting capabilities of Stemwriter 
are extensive, powerful, logical, and easy to use. This body of text 
contains examples of Footnoting, Reserved Fields, Bolded text, Local 
Fields, Superscripting, Double Strike, and Underlining. In conjunction 
with the instructions in the Tutorial Manual, Headings and Footings may 
be added, pages may be numbered in the nominated position, and so on. I 
hope you enjoy trying out as many formatting permutations as you can 
think of! Bonne Chance! 



ON WORD PROCESSING 


1 

When one is introduced to a stranger, a first impression of strength 2 
varying from instant like, through ho-hum, to instant dislike, is 3 
formed. This first impression is modified in the light of subsequent 4 
contacts, as less obvious facets of their character are highlighted by 5 
differing circumstances, and different times. Thus, our first 6 
impressions are shaped and moulded by subsequent experiences. 7 

As it is with people, so it is with software. The more 9 
functionally complex the software, the truer this is. First impressions 10 
count, but may be a poor indicator of our final impression at the end of 11 
the day. The cute features which first attracted our attention, may, 12 
with time, appear shallow, annoying, and unnecessarily restrictive. 13 
This cycle is particularly relevant to word processing software. 14 

There are many different ways, and for different purposes, that 16 
people wish to manipulate words, ranging from computer source code, 17 
through form letters, and the latest in steamy novels, to Nobel Prize 18 
winning papers. Consequently, the generic, intuitive, all-purpose 19 
program with a chameleon User Interface which adapts to the individual 20 
personality of the user, is highly sought after, but remains an elusive 21 
dream. However, below this level, great advances have been made, both 22 
in terms of the power to manipulate words and characters, and the ease 23 
with which this may be done. Several evolutionary stages have already 24 
been passed through, as shown in Figure 1. 25 

User Interface 

Question & Answer > Remember & Type > Recognize & Point > Listen & Print 
Figure 1 Stages in User Interface Design 

26 

27 

The first Editors were line oriented editors designed for the entry 29 
and manipulation of program source code on mainframe computers. The 30 

1 



prime emphasis was on "getting the job done" - that is, providing the 1 
text manipulation features which made the handling of program source 2 
code easy. User interfaces were rudimentary, because the users were 3 
computer-literate, and got a "buzz" out of using obscure and arbitrary 4 
command sequences. Some editors developed to the stage of becoming 5 
pseudo-languages in their own right, such as TECO , which is capable of 6 
prodigious feats of text manipulation, but is as safe to use as a loaded 7 
rifle with a faulty safety catch. 8 

At some later stage, it was recognized that general computerised 10 
text editing had applications far beyond the narrow confines of editing 11 
and correcting FORTRAN and COBOL source code. Thus appeared the first 12 
dedicated word processors. It was soon realized that the rudimentary 13 

user interfaces masochistically loved by computer sophisticates, cut no 14 

ice with people who did not know (or care) the difference between a bit 15 
and a byte. Consequently, a significant effort was put into the design 16 
of the user interface. 17 

Sadly for some, the day of the dedicated word processor was as 19 

short as the life of a mayfly in spring, as they were overtaken, and 20 
superceded by the cheaper, and more versatile microcomputer. Initially, 21 
text and word processing facilities provided on microcomputers were 22 

transported (philosophically and physically) from the mainframe and 23 
mini-computer worlds. Consequently, the same evolutionary path has been 24 
followed (Figure 1), with the user interface progressing from "Question 25 
and Answer" through to "Recognize and Point". We have still to reach 26 
the ultimate (or penultimate?) state of "Listen and Type". 27 
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Concurrently with improvements in User Interface design, there has 1 
been a re-assessment of the whole operating environment. We started off 2 
with the Ultimate in free-form, the pencil & paper, capable of putting 3 
arbitrary shaped marks anywhere at will, to the faster and more legible 4 
(but more restrictive) typewriter, to the strongly mode-oriented word 5 
processor. We are now beginning to see a breaking down of the mode- 6 
generated restrictions, as we drive full-circle towards the computer- 7 
aided free-form placement of arbitrary marks. Such is life. 8 

Stemvriter represents one point in the continuum of User Interface 10 
Design, and Operating Characteristics. It has an advanced and intuitive 11 
User Interface, and mode-oriented operation has been almost entirely 12 
scrapped. It is therefore no accident that Stemwriter is ’'State of the 13 
Art" in both these areas. 14 

The earliest text editors had very rudimentary formatting 16 
capability. In contrast, the text formatting capabilities of Stemwriter 17 
are extensive, powerful, logical, and easy to use. This body of text 18 
contains examples of Footnoting, Reserved Fields, Bolded text, Local 19 
Fields, Superscripting, Double Strike, and Underlining. In conjunction 20 
with the instructions in the Tutorial Manual, Headings and Footings may 21 
be added, pages may be numbered in the nominated position, and so on. I 22 
hope you enjoy trying out as many formatting permutations as you can 23 
think of! Bonne Chance! 24 
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OH WORD PROCESSING 


When one is introduced to a 
stranger, a first impression of 
strength varying from instant like, 
through ho-hum, to instant dislike, 
is formed. This first impression 
is modified in the light of 
subsequent contacts, as less 
obvious facets of their character 
are highlighted by differing 
circumstances, and different times. 
Thus, our first impressions are 
shaped and moulded by subsequent 
experiences. 

As it is with people, so it is 
with software. The more 
functionally complex the software, 
the truer this is. First 
impressions count, but may be a 
poor indicator of our final 
impression at the end of the day. 
The cute features which first 
attracted our attention, may, with 
time, appear shallow, annoying, and 
unnecessarily restrictive. This 
cycle is particularly relevant to 
word processing software. 

There are many different ways, 
and for different purposes, that 
people wish to manipulate words, 
ranging from computer source code, 
through form letters, and the 
latest in steamy novels, to Nobel 
Prize winning papers. 
Consequently, the generic, 
intuitive, all-purpose program with 
a chameleon User Interface which 
adapts to the individual 
personality of the user, is highly 
sought after, but remains an 
elusive dream. However, below this 
level, great advances have been 
made, both in terms of the power to 
manipulate words and characters, 
and the ease with which this may be 
done. Several evolutionary stages 
have already been passed through, 
as shown in Figure 1. 


The first Editors were line 
oriented editors designed for the 
entry and manipulation of program 
source code on mainframe computers. 
The prime emphasis was on "getting 
the job done" - that is, providing 
the text manipulation features 
which made the handling of program 
source code easy. User interfaces 
were rudimentary, because the users 
were computer-literate, and got a " 
buzz" out of using obscure and 
arbitrary command sequences. Some 
editors developed to the stage of 
becoming pseudo-language^ in their 
own right, such as TECO , which is 
capable of prodigious feats of text 
manipulation, but is as safe to use 
as a loaded rifle with a faulty 
safety catch. 


At some later stage, it was 
recognized that general 
computerised text editing had 
applications far beyond the narrow 
confines of editing and correcting 
FORTRAN and COBOL source code. 
Thus appeared the first dedicated 
word processors. It was soon 
realized that the rudimentary user 
interfaces masochistically loved by 
computer sophisticates, cut no ice 
with people who did not know (or 
care) the difference between a bit 
and a byte. Consequently, a 
significant effort was put into the 
design of the user interface. 

Sadly for some, the day of the 
dedicated word processor was as 
short as the life of a mayfly in 
spring, as they were overtaken, and 
superceded by the cheaper, and more 
versatile microcomputer. 
Initially, text and word processing 
facilities provided on 
microcomputers were transported 
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Figure 1 Stages in User Interface Design 


(philosophically and physically) 
from the mainframe and mini* 
computer worlds. Consequently, the 
same evolutionary path has been 
followed (Figure 1), with the user 
interface progressing from " 
Question and Answer" through to " 
Recognize and Point". We have 
still to reach the ultimate (or 
penultimate?) state of "Listen and 
Type". 
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Concurrently with improvements 
in User Interface design, there has 
been a re-assessment of the whole 
operating environment. We started 
off with the Ultimate in free-form, 
the pencil & paper, capable of 
putting arbitrary shaped marks 
anywhere at will, to the faster and 
more legible (but more restrictive) 
typewriter, to the strongly mode- 


oriented word processor. We are 
now beginning to see a breaking 
down of the mode- generated 
restrictions, as we drive full- 
circle towards the computer* aided 
free-form placement of arbitrary 
marks. Such is life. 

Stemwriter represents one 
point in the continuum of User 
Interface Design, and Operating 
Characteristics. It has an 
advanced and intuitive User 
Interface, and mode-oriented 
operation has been almost entirely 
scrapped. It is therefore no 
accident that Stemwriter is "State 
of the Art" in both these areas. 

The earliest text editors had 
very rudimentary formatting 
capability. In contrast, the text 
formatting capabilities of 
Stemwriter are extensive, powerful, 
logical, and easy to use. This 
body of text contains examples of 
Footnoting, Reserved Fields, Bolded 
text. Local Fields, Superscripting, 
Double Strike, and Underlining. In 
conjunction with the instructions 
in the Tutorial Manual, Headings 
and Footings may be added, pages 
may be numbered in the nominated 
position, and so on. I hope you 
enjoy trying out as many formatting 
permutations as you can think of! 
Bonne Chance! 
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ON WORD PROCESSING 


When one is introduced to 
a stranger, a first impr¬ 
ession of strength vary¬ 
ing from instant like, 
through ho-hum, to inst¬ 
ant dislike, is formed. 
This first impression is 
modified in the light of 
subsequent contacts, as 
less obvious facets of 
their character are high¬ 
lighted by differing cir¬ 
cumstances, and different 
times. Thus, our first 
impressions are shaped 
and moulded by subsequent 
experiences. 

As it is with peo¬ 
ple, so it is with softw¬ 
are. The more functiona¬ 
lly complex the software, 
the truer this is. First 
impressions count, but 
may be a poor indicator 
of our final impression 
at the end of the day. 

The cute features which 
first attracted our atte¬ 
ntion, may, with time, 
appear shallow, annoying, 
and unnecessarily restri¬ 
ctive. This cycle is 
particularly relevant to 
word processing software. 

There are many diff¬ 
erent ways, and for diff¬ 
erent purposes, that peo¬ 
ple wish to manipulate 
words , ranging from comp¬ 
uter source code, through 
form letters, and the 
latest in steamy novels, 
to Nobel Prize winning 
papers. Consequently, 
the generic, intuitive, 
all-purpose program with 
a chameleon User Interf¬ 
ace which adapts to the 
individual personality of 
the user, is highly sou¬ 


ght after, but remains an 
elusive dream. However, 
below this level, great 
advances have been made, 
both in terms of the 
power to manipulate words 
and characters, and the 
ease with which this may 
be done. Several evolut¬ 
ionary stages have alre¬ 
ady been passed through, 
as shown in Figure 1. 

The first Editors 
were line oriented edit¬ 
ors designed for the 
entry and manipulation of 
program source code on 
mainframe computers. The 
prime emphasis was on " 
getting the job done" - 
that is, providing the 
text manipulation featu¬ 
res which made the handl¬ 
ing of program source 
code easy. User interfa¬ 
ces were rudimentary, 
because the users were 
computer-literate, and 
got a "buzz" out of using 
obscure and arbitrary 
command sequences. Some 
editors developed to the 
stage of becoming pseudo¬ 
languages in their own 
right, such as TECO , 
which is capable of prod¬ 
igious feats of text man¬ 
ipulation, but is as safe 
to use as a loaded rifle 
with a faulty safety 
catch. 

At some later stage, 
it was recognized that 
general computerised text 
editing had applications 
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far beyond the narrow 
confines of editing and 
correcting FORTRAN and 
COBOL source code . Thus 
appeared the first dedic¬ 
ated word processors. It 
was soon realized that 
the rudimentary user int¬ 
erfaces masochistically 
loved by computer sophis¬ 
ticates , cut no ice with 
people who did not know 
(or care) the difference 
between a bit and a byte. 
Consequently, a signific¬ 
ant effort was put into 
the design of the user 
interface. 

Sadly for some, the 
day of the dedicated word 
processor was as short as 
the life of a mayfly in 
spring, as they were ove¬ 
rtaken, and superceded by 
the cheaper, and more 
versatile microcomputer. 
Initially, text and word 
processing facilities 
provided on microcomput¬ 
ers were transported 
(philosophically and phy¬ 
sically) from the mainfr¬ 
ame and mini-computer 
worlds. Consequently, 
the same evolutionary 
path has been followed 
(Figure 1), with the user 
interface progressing 
from "Question and Ans¬ 
wer" through to "Recogn¬ 
ize and Point". We have 
still to reach the ultim¬ 
ate (or penultimate?) 
state of "Listen and 
Type". 

Concurrently with 
improvements in User Int¬ 
erface design, there has 
been a re-assessment of 
the whole operating envi- 
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ronment. We started off 
with the Ultimate in 
free-form, the pencil & 
paper, capable of putting 
arbitrary shaped marks 
anywhere at will, to the 
faster and more legible 
(but more restrictive) 
typewriter, to the stron¬ 
gly mode-oriented word 
processor. We are now 
beginning to see a break¬ 
ing down of the mode¬ 
generated restrictions, 
as we drive full-circle 
towards the computer- 
aided free-form placement 
of arbitrary marks. Such 
is life. 

Stemwriter represe¬ 


nts one point in the con¬ 
tinuum of User Interface 
Design, and Operating 
Characteristics. It has 
an advanced and intuitive 
User Interface, and mode- 
oriented operation has 
been almost entirely scr¬ 
apped. It is therefore 
no accident that Stemwri¬ 
ter is "State of the Art" 
in both these areas. 

The earliest text 
editors had very rudimen¬ 
tary formatting capabil¬ 
ity. In contrast, the 
text formatting capabili¬ 
ties of Stemwriter are 


extensive, powerful, log¬ 
ical, and easy to use. 
This body of text conta¬ 
ins examples of Footnot¬ 
ing, Reserved Fields, 
Bolded text, Local Fie¬ 
lds, Superscripting, Dou¬ 
ble Strike, and Underlin¬ 
ing. In conjunction with 
the instructions in the 
Tutorial Manual, Headings 
and Footings may be 
added, pages may be numb¬ 
ered in the nominated 
position, and so on. I 
hope you enjoy trying out 
as many formatting permu¬ 
tations as you can think 
of! Bonne Chance! 
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Ms Jill A. Jones, 
96 Oak St, 
Enmaville. 42136 


October 12, 1984 


Dear Jill, 

I am writing this letter to congratulate you on the excellent 
Lingerie sales you achieved last month. If you continue to achieve such 
good sales for the rest of the year, Jill, you will find a healthy bonus 
in yoiur end of year pay cheque. 

Now remember our Company's motto, Jill, 'IN HOME PRODUCTS belong in 
homes'. Keep up the good work. 


Kind Regards, 


Big Boss 

In Home Selling Inc. 



October 12, 1984 


Mrs Jane W. Johnson, 
43 Peteunia Avenue, 
rosevale. 98765 


Dear Jane, 

I am writing this letter to congratulate you on the excellent 
Cosmetics sales you achieved last month. If you continue to achieve 
such good sales for the rest of the year, Jane, you will find a healthy 
bonus in yoiur end of year pay cheque. 

Now remember our Company's motto, Jane, 'IN HOME PRODUCTS belong in 
homes'. Keep up the good work. 


Kind Regards, 


Big Boss 

In Home Selling Inc. 



Mr Peter M. Smith, 
294 Crescent Drive 
Waratah. 45678 


October 12, 1984 


Dear Peter, 

I am writing this letter to congratulate you on the excellent 
Cleaning Products sales you achieved last month. If you continue to 
achieve such good sales for the rest of the year, Peter, you wiil find a 
healthy bonus in yoiur end of year pay cheque. 

Now remember our Company's motto, Peter, 'IN HOME PRODUCTS belong 
in homes'. Keep up the good work. 


Kind Regards, 


Big Boss 

In Home Selling Inc. 
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Articles 


(1) To carry on business as investors financiers and merchants and to 
undertake and carry on and execute all kinds of investments 
financial commercial trading and other operations and to carry on 
any other business which may seem to be capable of being 
conveniently carried on in connection with any of .these objects or 
calculated directly or indirectly to enhance the value of or 
facilitate the realization of or render profitable any of the 
Company's property or rights. 

(2) To advance deposit or lend money securities and property to or with 
such persons and on such terms as may seem expedient to draw make 
accept endorse discount buy sell and deal in Bills of Exchange 
Promissory Notes Bills of Lading Warrants Debentures Hire-Purchase 
Agreements and other negotiable or transferable securities or 
documents. 

(3) To facilitate and encourage the creation issue or conversion of 

debentures debenture stock bonds obligations shares stocks and 
securities and to act as trustees in connection with any such 
securities and to take part in the conversion of business concerns 
and undertakings into companies and to carry on the business of and 
to act as nomineess custodian trustee trustees attorney 

representative or agent of any perrson or class of persons whether 
ascertained or not or of any company or body and whether 
incorporated or not and to manage estates affairs businesses and 
investments. 

(4) To carry on any wholesale or retail business or any business 

relating to primary production manufacturing transport distribution 
exchange contracting finance banking insurance trade or commerce or 
any other business whatsoever that may seem to the Directors 

capable of being carried on in connection with the above or 
calculated directly or indirectly to enhance the value of or render 
profitable any of the Company's property or rights. 



Sample Equations 


REDUCTION OF THE 3 ZONE UNSTEADY MODEL TO THE 
LANGMUIR TISSUE BINDING MODEL 


Consider the case where the unchanged drug, C* and the metabolite, 

2 J 
C are in equilibrium in the non-metabolic tissue zone, zone 3. This 

** # • i • 2 

can only occur if Cand C* are both zero. 


Thus, equations 5.17 and 5.20 become: 

■ 0 - k 5 3 c J [ v (c 5 +c 3 )] - k lA 

62 - 0 - ^0 2 l lZ 3-AA )] - k 31 C 3 2 


....A2.1 


-A2.2 


From equations A2.1 and A2.2, we have on re-arranging: 

-A2.3 


V < °i* C 3> ’ k 31 C 3 /<k i3 C l > 

V <C H> ' k 31 C 3 /(k 13 C l > 


....A2.4 


1 2 

Combining equations A2.3 and A2.4 to eliminate Z^-(C^+C.j) gives: 

k 2 C 2 /(k 2 C 2 ) - k 1 C^/Ck 1 C 1 ) 

31 3 13 1 31 3 13 1 


Thus 


c 3 " k 3i c i k n c i /(k i 3 c l k 3i ) 


-A2.5 


Substituting for C* from equation A2.5 into equation A2.4 and 
transposing gives: 


Z 3 “ + k 5i C 3 /(k l 3 C l ) + k 31 C 3 k 13 C l /(k 13 C l k 31 } 



THE DO-NOTHING CLUB 


213 Sedate St 
HURRYVILLE 4044 
February 10, 1984. 


Dear Member, 

This letter is to inform you of the arrangements for the Annual 
Picnic Meeting and Conference of the Do-Nothing Club. This Year, the 
Picnic will be held at North Pine Ridge Picnic Reserve, Hurryville on 
Monday, 12th March 1984, commencing at 9.00 a.m. 

Following the Picnic, the Annual General Meeting will be convened, 
and the Office Bearers for 1984 will be elected. If you have any 
business for the meeting, please notify me in writing before 12th 
February. 

The topic for the Conference this year is "Passive Recreation in an 
Active Society", so please come prepared to take part in an 
appropriately sedate debate. 

By the way, you may like to consider the following note which was 
sent to me as Honorary Club Secretary, by the President of the Busy Bees 
Club. 


The Busy-Bees Club cordially invites all Members of the 
Do-Nothing Club to their Annual Masked Ball and Dancing 
Competition, to be held on March 24th, 1984, commencing at 
8.00pm. As you all know, this event is the highlight of the 
Hurryville Social Calendar for 1984. He hope that as in 
previous years, the Do-Nothing Club members will carry out 
the Charter of their Club, i.e. 'Members are not to 
participate in physically demanding activities, when they 
can get just as tired by watching. We further hope that the 
senior members of your Club will, as usual, become 
pleasantly exhausted just by thinking of attending. 

So there, our Annual Social calendar is filled already, leaving 
plenty of time this year for doing what we do best. 

See you there 


I M Lazy 
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5. RESTRICTIONS ON USE AND TRANSFER. The original and any back-up 

copies of this Software are intended for your personal use in 
connection with a single computer. You may not distribute copies 
of this Software, or its Documentation. You may transfer this 
license to another User, provided that all items noted on the 
Packing Slip, without exception, and any additional back-up copies, 
or copies of the documentation are included in the transfer. The 
transferee may become a Licensed User, by notifying STEMSOFT in 
writing within 14 days of the date of transfer. 

6. MEDIA WARRANTY. To the Original Licensee only, STEMSOFT warrants the 

diskettes on which the Software is recorded, to be free from 
defects in materials and faulty workmanship under normal use for a 
period of 30 days after the date of receipt of the Software. If, 
during this 30 day period, a defect in the diskette should occur, 
the diskette and a copy of your receipt should be forwarded to 
STEMSOFT, who will replace the diskette without charge. Following 
the 30 day period, Users who have returned a completed Registration 
Form, may have defective diskettes replaced for a fee of $20. To 
the extent permitted by law, your sole remedy in the event of a 
defect in the diskette is limited to the replacement of the 
diskette as provided above. 

7. UPGRADES. STEMSOFT reserves the right to make changes to the 

Software, its Documentation, and new Licensing Arrangements without 
notice. The provision of revised Software to Licensees is at the 
Discretion of STEMSOFT, and under terms and conditions as set by 
STEMSOFT from time to time. 





